← Back to Autonomy

Field Guide · Tools for Thought

Obsidian, in Plain English

A note-taking app that quietly turns into a personal knowledge network — and why people pair it with an AI like Claude to build a “second brain.”

01The one-sentence answer


Obsidian is a note-taking app built on plain text files that live on your own computer, where notes can link to each other — and those links turn a pile of separate notes into a connected web of knowledge.

That’s really the whole idea. The two words that make Obsidian different from a normal notes app are local (the files are yours, sitting in a folder) and linked (notes point at each other, like pages on Wikipedia).

Mental model

Apple Notes is a drawer: you drop notes in and dig them out later. Obsidian is a city map: every note is a place, and the roads between them are the point.

02Folders vs. links — the core shift


Most apps make you choose one folder for each note. But real ideas belong in many places at once. A note on “battery thermal runaway” is part diagnostics, part chemistry, part safety. Folders force you to pick one shelf. Links let the note sit on all of them.

The Folder Way The Obsidian Way Folder: WorkFolder: Health Folder: Ideasnote note one home each · dead ends many connections · paths between ideas
Figure 1. Folders give each note a single home and create dead ends. Links (Obsidian’s graph) let one note connect to many, so you can travel from idea to idea.

The three building blocks

Notes (Markdown)

Plain .md text files. No special format, no lock-in — readable in any editor, forever.

Links

Type [[Note name]] to connect notes. Obsidian also shows backlinks: who links to this note.

The Vault

Just a normal folder on your disk holding all the notes. That folder is your knowledge base.

The Graph

An auto-drawn map of every note and link. Clusters reveal what you actually think about.

Practical note

You don’t have to plan a structure up front. Just write notes and link them when it feels natural. The structure emerges — this is why people call it a “bottom-up” or organic system instead of a rigid filing cabinet.

03Try it: the living graph


This is the part that’s hard to feel from a description, so here it is live. Each circle is a note; lines are links. Tap any note to see what it connects to — the same move you make in Obsidian when you follow a trail of thought.

Tap a note to light up its connections · tap empty space to reset

Notice how tapping one note reveals neighbors you might have forgotten were related. That’s the whole value of links over folders, made visible.

04Tags vs. links — when to use which


Obsidian has both, and beginners mix them up. The screenshot that started this even shows a “Tags” icon. The simple rule:

Links — relationships

[[Project Atlas]] says “this note is about or connected to that specific thing.” Use for real, meaningful ties.

Tags — loose buckets

#idea or #todo says “this belongs to a broad category.” Use for status and filtering across many notes.

Rule of thumb: if you could write a sentence about why two notes relate, use a link. If you just want to group lots of notes by type or status, use a tag. Links build the map; tags help you sweep across it.

05Properties — giving notes machine-readable structure


At the very top of a note you can add a small block of properties (also called frontmatter, written in YAML). It’s a handful of key–value fields that describe the note — its status, date, type, related people. Humans skim it; software can read it.

--- (this block sits at the top of the note)
title:   Bearing failure detection strategy
type:    decision
status:  in-review
date:    2026-06-07
tags:    [diagnostics, prognostics]
related: ["[[Vibration features]]", "[[RUL estimation]]"]
---
Why this matters for AI

Properties turn a free-text note into something an agent can filter and sort: “find every note where status: in-review and type: decision.” The same three-layer idea you’d use in a well-structured skill — discoverable metadata up top, content below.

06Daily notes — the easiest habit that works


The most reliable way to actually use Obsidian is the daily note: one note per day, named by date, where you dump whatever happens — tasks, calls, half-ideas. Because you link out from it as you write, each day becomes a hub that quietly wires everything together.

2026-06-07 daily note [[Sara]][[Atlas]] [[todo]][[idea]] [[meeting]][[risk]]
Figure 2. A daily note becomes a hub: as you jot the day down, every [[link]] you type threads it into the wider web — no extra filing required.
Practical note

Don’t treat daily notes as a diary to keep forever. Treat them as a landing strip: capture fast, then move anything worth keeping into its own linked note. The daily note can stay messy.

07Why “second brain”?


Your real brain is great at thinking but terrible at remembering details reliably. A second brain is an outside store that holds the facts, links, and context so your real brain is freed up to reason, not memorize.

The trick is that a second brain only works if retrieving something is as easy as writing it down. Folders make retrieval hard (which drawer did I put that in?). Links make it easy (follow the trail). That’s the entire promise.

Why links beat search

Search only finds what you remember to ask for. Links surface things you forgot you connected — the note about a meeting reminds you of the decision, which reminds you of the open risk. Serendipity, on purpose.

08Adding Claude: memory + reasoning


On its own, Obsidian is a great memory but it can’t think — it just stores. An AI like Claude is great at reasoning but has no memory of your world. Connect the two and each fixes the other’s weakness:

Memory Obsidian Vault linked .md notes your context Reasoning Claude analyse · connect · draft Output Second Brain decisions summaries new connected ideas notes in answers out save the good output back into the vault — the loop that compounds
Figure 3. The vault supplies memory, Claude supplies reasoning, and the result is written back — so the system gets richer every cycle.

The dotted return arrow is the part most people miss. If you only ask the AI questions, you get a chatbot. If you save its useful answers back as linked notes, your memory grows smarter every time. That feedback loop is what the original post meant by “that’s when the system finally works.”

09How the AI actually reads your notes


The AI can’t see your whole vault at once, so how does it use it? The common pattern is retrieval — fetch only the few notes relevant to your question, then hand those to the model as context. In plain terms: find the right pages, then read them, then answer.

Yourquestion Findrelevant notes Load notesas context Claudereasons Answer(+ save) ↑ search / links pick a handful, not the whole vault This “retrieve-then-read” pattern is the standard way to connect any AI to a personal knowledge base.
Figure 4. Retrieval keeps things practical: only the notes that matter for this question are pulled in, so the AI stays grounded in your real material.

10Three ways to connect them


You don’t need fancy tooling to start. Think of it as a ladder — climb only as far as you need.

1 · Copy-paste paste a note into Claude 2 · AI plugin community plugin in Obsidian 3 · Agent / MCP reads & writes the vault directly manual · zero setup automated · hands-off
Figure 5. A maturity ladder. Start at rung 1 — it teaches you what’s actually useful before you automate at rung 3.
Recommendation

Begin with copy-paste for a week or two. You’ll quickly learn which questions are worth asking and which notes are worth feeding in — then graduate to a plugin or an agent that reads the vault folder for you.

11Privacy — what actually leaves your machine


This is the catch nobody mentions in the hype posts. Obsidian itself is local-first: the notes sit on your disk and never go anywhere unless you send them. But the moment you pipe a note into a cloud AI, that text travels to the AI provider to be processed. Your second brain stops being purely private at exactly that step.

Before you connect anything

Keep secrets, passwords, regulated or confidential material out of any note you’ll send to a cloud model — or redact it first. If the content is sensitive, prefer a local model running on your own machine, or paste only the specific excerpt the AI needs rather than the whole note.

Your vault is just files — treat it like files

12A worked example — the loop, concretely


Abstract diagrams are easy to nod at. Here’s the actual loop with real text. Say you have three rough notes from the week — a meeting, a test result, and an open question. You select them and prompt:

# Prompt to Claude
Here are three notes from this week (pasted below).
Summarize them into a single decision note: what we
decided, what's still open, and the next action. Add
property fields and link back to the source topics.

Claude reasons over them and hands back a clean, structured note. You paste it into the vault as a new file — that’s the dotted arrow from Figure 3 made real:

  Decisions/2026-06-07 Sensor sampling rate.md
type: decision status: agreed date: 2026-06-07 related: ["[[Edge triage]]", "[[Data acquisition]]"] tags: [vhm, edge]

Decision: raise edge sampling to 2 kHz on anomaly

Decided. Default sampling stays low; the [[Edge triage]] node bumps to 2 kHz only when an anomaly score crosses threshold, to control upload cost.

Still open. Threshold value isn’t set — depends on the [[Data acquisition]] campaign results due next week.

Next action. Sara to run the campaign and report the false-trigger rate. See [[Sara]].

Now that note is linked into the web. Next month, opening [[Edge triage]] shows this decision as a backlink — the reasoning is permanently wired into your memory instead of lost in a chat window.

13A practical starter setup


  1. Install Obsidian and create one vault (a folder). Don’t make many — one is plenty to start.
  2. Turn on daily notes (a core plugin). Make that your capture habit.
  3. Write as you normally would. When a note mentions a concept, person, or project that deserves its own note, wrap it in [[ ]].
  4. Add an index note — a single “Map of Content” that links to your main topics. Your front door.
  5. Open the graph weekly. Lonely, unlinked notes are a hint to connect or delete.
  6. Bring in Claude for the heavy thinking — summarize, find gaps, draft — then paste results back as a new linked note.
Common traps

Over-organizing: people spend weeks on folder structures and plugins instead of writing. Links matter more than folders. Hoarding: saving without linking just rebuilds the messy drawer. A note with zero links is barely in your second brain at all.

The 30-second test

After writing any note, ask: “What two existing notes should this connect to?” Add those links. Do only that, consistently, and the graph builds itself.

14Obsidian vs. the others


Obsidian isn’t always the right pick. A quick orientation against the tools it’s usually compared to:

Table 1. A rough orientation — every tool overlaps, but each leans somewhere.
ObsidianNotionApple NotesRoam
Where notes liveLocal plain-text files (yours)Notion’s cloudApple’s cloudRoam’s cloud
LinkingFirst-class[[ ]] + backlinksPossible, more manualNone to speak ofFirst-class, core idea
Works offlineFullyPartialFullyLimited
Databases / tablesBasic (via plugins)ExcellentNoBasic
Team collaborationWeak (built for solo)StrongLight sharingModerate
Best forLinked personal knowledge, long-term thinkingTeam docs & structured databasesFast everyday captureNetworked daily thought
CostFree for personal useFreemiumFree with Apple devicePaid

15When not to use Obsidian


An honest field guide says where the tool fits poorly:

The honest summary

Obsidian shines when you’re building knowledge over time and want to own it. For one-off capture or team docs, simpler or cloud-native tools win. Pick the tool you’ll actually keep open.

16The idea in one diagram


Raw, scattered notes Linked + reasoned Your second brain AI
Figure 6. The whole journey: messy fragments → linked and reasoned over → a structured network you can actually think with.

Obsidian remembers. Claude reasons. The link between them — and the habit of saving results back — is what turns a notes app into a second brain.

17Glossary


Vault
The folder on your disk that holds all your notes. It is your knowledge base — nothing is hidden in a database.
Markdown
A simple plain-text format for writing formatted notes (**bold**, # headings). Readable anywhere, forever.
Link
A connection from one note to another, written [[Note name]]. The thing that makes Obsidian a network.
Backlink
The reverse view: every other note that links to the one you’re reading. Surfaces forgotten connections.
Graph
The auto-drawn map of all notes and links. Clusters show what you actually think about.
Properties
Key–value fields at the top of a note (frontmatter/YAML) describing it — status, date, type — readable by humans and software.
Tag
A loose category label like #idea. Good for grouping; weaker than a link for real relationships.
Daily note
One note per day for fast capture; becomes a hub as you link out from it.
RAG
Retrieval-augmented generation: fetch the few relevant notes, then let the AI read and answer from them.
MCP
Model Context Protocol — an open standard letting an AI agent read and write outside sources, such as your vault.

18References & further reading


  1. Obsidian — official site and documentation. obsidian.md · help.obsidian.md
  2. Obsidian Help — Internal links, Backlinks, Properties, and Daily notes.
  3. Tiago Forte, Building a Second Brain (2022) — the CODE method (Capture, Organize, Distill, Express).
  4. Niklas Luhmann’s Zettelkasten — the linked-notes method that inspired tools like Obsidian and Roam.
  5. Markdown — John Gruber’s original spec. daringfireball.net/projects/markdown
  6. Retrieval-augmented generation (RAG) — the “retrieve-then-read” pattern behind Figures 4–5.
  7. Model Context Protocol (MCP) — an open way to let AI agents read/write external sources. modelcontextprotocol.io
Note on sources

Links point to primary/official sources. Concepts like the Zettelkasten and “second brain” are widely documented; these are starting points rather than an exhaustive bibliography.