Most people use Obsidian as a filing cabinet.
Notes go in. Notes stay there. Occasionally you search for one and find it. You read it. You close it. It goes back to sitting alone in its folder.
That is not a second brain.
That is an expensive text editor.
The feature that transforms Obsidian from a filing cabinet into a thinking system is linking. Specifically the ability to create connections between notes that mirror the way ideas actually relate to each other in your mind.
When your notes are linked they stop being isolated documents and start being a network of knowledge.
A thought you captured six months ago becomes visible when you are working on something related today.
A pattern that exists across twelve different notes becomes identifiable without you manually reading all twelve.
A decision you made in January becomes context for a decision you are making in May without you having to remember that January even happened.
This article is the complete guide to linking in Obsidian. What it is, how it works, every linking method available, and the specific practices that turn a collection of connected notes into genuine intellectual leverage.
What Linking Actually Does to Your Thinking
Before the mechanics understand the principle.
Human memory is associative. You do not remember things in isolation. You remember them in relation to other things. A smell triggers a memory. A word triggers a concept. A concept triggers a connected concept.
The traditional folder system ignores this. It organizes notes by category the way a library organizes books by subject. The chemistry books are in the chemistry section. The history books are in the history section. A book that connects chemistry to history is shelved in one place or the other. The connection is lost in the shelving decision.
Obsidian's linking system does not make you choose.
A note about a chemistry concept can be linked to a note about a historical event without either note moving anywhere. The connection exists independently of the storage location.
Over time your vault stops being a collection of categorized notes and starts being a map of how your ideas connect.
That map is where the real thinking lives.
The Three Types of Links in Obsidian
Obsidian has three distinct linking mechanisms. Each one serves a different purpose and creates a different kind of connection.
Internal Links
Internal links connect one note to another note inside your vault.
The syntax is double brackets around the note name:
[[Note Name]]
When you type this in any note Obsidian creates a clickable link to the referenced note. Click the link and you navigate to that note instantly.
If the referenced note does not exist yet Obsidian creates an unresolved link shown in a different color. This is actually a feature not a bug. You can reference a note you intend to create before you create it and Obsidian tracks the connection as a placeholder.
Internal links are the foundation of every linked vault. Every other linking mechanism builds on top of them.
Block Links
Block links connect to a specific paragraph or section within a note rather than to the entire note.
The syntax adds a caret and a block identifier:
[[Note Name#^block-id]]
You do not write the block identifier manually. Type the double brackets and the note name, add the caret, and Obsidian shows you a list of blocks in that note to select from. It generates the identifier automatically.
Block links are valuable when the specific context matters. Linking to an entire note about a project pulls everything in that note into the connection. Linking to the specific paragraph about a decision pulls only that decision into the connection.
Use block links when precision matters more than breadth.
Heading Links
Heading links connect to a specific section of a note identified by its heading.
The syntax adds a hash and the heading name:
[[Note Name#Heading Name]]
Heading links occupy the middle ground between note links and block links. They connect to a section of a note rather than the entire note or a single paragraph.
Use heading links when a note has multiple distinct sections and you want to reference one section specifically without creating a separate note for it.
Creating Links: The Practical Workflow
The mechanical process of creating links is simple. The judgment about when and what to link is the skill that develops over time.
Linking while writing:
As you write any note you will naturally reference things that exist or should exist elsewhere in your vault. The habit to build is creating the link at the moment of reference rather than after the fact.
When you write about a concept and realize you have notes on that concept somewhere in your vault stop and create the link immediately. Type the double brackets and start typing the note name. Obsidian autocompletes from your existing notes.
Linking during review:
Set aside time periodically to review recent notes and add links you did not create while writing. The connections that are visible on review are often different from the ones that were obvious while writing. Both are valuable.
Creating new notes from links:
When you reference something that does not have its own note yet create an unresolved link first. The unresolved link acts as a placeholder and a reminder. When you have enough material for a proper note on that concept you create it and the link resolves automatically.
The Backlink Panel: Where the Magic Happens
Creating links is the input.
The backlink panel is where the value appears.
Every note in Obsidian has a backlink panel that shows every other note in the vault that links to the current note.
This is the feature that makes linking transformative.
When you open a note and check its backlinks you see every context in which you referenced that idea across your entire vault. Every project that mentioned it. Every decision that referenced it. Every daily note that brought it up.
Without backlinks: you remember a concept exists. You search for the note. You read it in isolation.
With backlinks: you open the note and immediately see the full constellation of contexts where that concept appeared in your thinking. The concept is not isolated. It is embedded in your intellectual history.
The pattern that emerges from seeing backlinks over time is the most underrated feature in any note-taking tool. You thought you referenced something three or four times. The backlinks show you referenced it twenty-two times across three years. That frequency is itself information. It tells you what ideas are actually structuring your thinking versus the ones you think are important.
The Graph View: Seeing Your Knowledge As a Network
The graph view renders every note in your vault as a node and every link as a connection between nodes.
The visual that emerges is a map of your knowledge.
Notes with many connections appear as large nodes at the center of clusters. Notes with few connections appear as small nodes at the periphery.
The clusters themselves reveal structure you did not consciously create. Topics you think about frequently and from many angles cluster together naturally. Topics you captured once and never connected sit alone at the edges.
The graph view is not primarily a navigation tool. You rarely use it to find a specific note. Its value is in the perspective it provides on your knowledge as a whole.
Opening the graph view after six months of consistent linking and seeing the clusters that have formed shows you something you could not see from inside any individual note. It shows you what your thinking is actually about versus what you think it is about.
The most connected nodes are your genuine intellectual interests.
The isolated nodes are the ideas you collected but never integrated.
Both insights are valuable.
Aliases: Linking to the Same Note Multiple Ways
Real concepts have multiple names.
You might have a note called "Second-Order Thinking" but refer to it as "downstream effects" or "thinking about consequences" in different notes.
Without aliases you would have to use the exact note name every time or create multiple notes for the same concept.
Aliases let you create multiple names for a single note. Every alias links to the same note.
Add aliases in the note's frontmatter:
---
aliases: [downstream effects, thinking about consequences, second-order effects]
---
Now when you type any of these phrases in double brackets Obsidian recognizes them as references to the Second-Order Thinking note.
Aliases keep your network coherent when your vocabulary for a concept evolves over time. The connections accumulate in one place rather than fragmenting across multiple notes.
Unlinked Mentions: Finding Connections You Missed
The unlinked mentions panel shows every note in your vault that mentions the current note's name or its aliases without linking to it.
These are connections that exist as words but have not been formalized as links.
Checking unlinked mentions regularly reveals the connections your past self created through writing but never captured as explicit links.
The workflow: open a note you consider important. Check unlinked mentions. Review each one and decide whether the mention warrants a formal link. If it does add the link in one click directly from the unlinked mentions panel.
This practice is one of the highest-leverage maintenance activities in a linked vault. It turns accidental connections into intentional ones and dramatically increases the density of your knowledge network over time.
MOCs: The Structure Layer for Large Vaults
As your vault grows the flat network of linked notes benefits from a structural layer.
Maps of Content are notes whose primary purpose is to link to other notes rather than to contain original ideas.
A MOC for a topic you think about frequently might contain nothing but links organized under headings.
# Second-Order Thinking MOC
## Core Concept Notes
[[What Second-Order Thinking Is]]
[[Why First-Order Thinking Fails]]
[[The Chesterton's Fence Principle]]
## Applications
[[Second-Order Thinking in Investing]]
[[Second-Order Thinking in Product Decisions]]
[[Second-Order Thinking in Hiring]]
## Related Concepts
[[Systems Thinking]]
[[Feedback Loops]]
[[Unintended Consequences]]
## My Applications
[[Decision: Pricing Change 2025]]
[[Decision: New Client Acceptance Criteria]]
The MOC is not a folder. You do not move notes into it. You link to notes from it.
The MOC can itself be linked from other notes and from your daily notes. It becomes a hub that makes any cluster of related notes navigable from a single reference point.
MOCs are optional. Many excellent vaults never use them. They become valuable when a topic has accumulated enough notes that navigating the cluster through backlinks alone becomes difficult.
The Daily Note as a Linking Hub
Daily notes are the most natural place to build linking habits.
Every daily note you write is a timestamped context layer for your vault. The ideas, projects, meetings, and decisions that appear in a daily note are connected to a specific moment in time.
When you link from daily notes to concept notes you create a temporal trail through your knowledge. You can look at any concept note and see through its backlinks exactly when and in what contexts you were thinking about it.
The linking habit that delivers the most value in daily notes is simple: any time you write about a concept, project, person, or decision that has or should have its own note add the double bracket link.
Over time your daily notes become a navigable record of your intellectual history rather than a diary that has to be read chronologically to be useful.
Claude Code and Smart Linking
Connected to your vault via MCP, Claude Code transforms linking from a manual practice into an intelligent automated process.
Three specific prompts that use the connection layer to produce outputs that isolated notes cannot:
The connection finder:
Read the note [[NOTE NAME]] and search my entire vault for
notes that are related but not yet linked.
For each potential connection identify:
- The related note
- The specific reason these notes should be connected
- Whether the connection is strong enough to warrant a link
or just a passing mention
Only surface non-obvious connections. Skip anything that is
already linked or obviously related by keyword.
This prompt finds the connections that exist in the content but never became explicit links. Run it on your most important notes and you will find connections you missed.
The synthesis prompt:
Read the note [[CONCEPT NOTE]] and all notes that link to it.
Synthesize what my vault as a whole says about this concept.
What is the consistent thread across all the notes?
What tension or contradiction exists between different notes?
What is the most important insight that emerges from
seeing all these notes together that no single note contains?
This synthesis does not exist in any individual note.
It only exists across the network.
This is where linked notes become more than the sum of their parts. Claude reads the entire connected cluster and produces insight that requires seeing all of them together.
The gap finder:
Read my MOC for [[TOPIC]].
Based on all the notes linked from this MOC and their
backlinks, identify:
- What aspects of this topic are well-covered
- What aspects have only one or two notes (fragile coverage)
- What aspects appear in other notes but have no dedicated
note of their own
- What note would add the most value to this cluster
if I wrote it this week
This prompt turns your linked vault into a research agenda. It shows you where your thinking is developed and where it has gaps worth filling.
The Compounding Effect of Consistent Linking
The value of a linked vault does not increase linearly.
It compounds.
In the first month you have dozens of notes with a handful of connections each. The graph view shows a sparse network. The backlinks panel is thin. The unlinked mentions finder does not find much.
In month six you have hundreds of notes with dozens of connections each. The graph view shows clear clusters. The backlinks panel reveals the full context of every important concept. The synthesis prompts produce insights that genuinely surprise you.
In year two you have thousands of notes with hundreds of connections across the most important concepts. The vault has become a genuine external memory that holds intellectual context you could never hold in your head.
The concepts you think about most frequently have the richest networks.
The decisions you made in the past are visible in their full context.
The patterns in your thinking are identifiable from the graph.
The synthesis available from any cluster of connected notes is greater than what any individual note contains.
This is what a second brain actually means.
Not a place to store notes.
A network of connected knowledge that thinks alongside you.
Start linking every note you write today.
The network compounds from the first connection.
Follow @cyrilXBT for every Obsidian practice, Claude Code prompt, and vault architecture that makes your knowledge system compound over time.
