Skip to main content

📝 Lesson 3.1: Internal Links & Backlinks

This is the lesson that turns Obsidian from "a nice text editor" into a second brain. Everything before now was preparation. Today you learn the one skill that makes the whole thing come alive: connecting notes with links — and then watching your notes tell you how they're connected, all on their own.

📚 What You'll Learn

By the end of this lesson, you will be able to:

  • Create internal links by typing [[ and using the autocomplete, including aliases, heading links, and block links
  • Use unresolved ("ghost") links to create notes on click — and adopt the powerful "link first, create later" workflow
  • Read the Backlinks pane (linked and unlinked mentions) and the Outgoing links pane to see a note's full web of connections
  • Explain why links beat folders — how one note can live in many contexts at once

⏱️ Estimated Time: 55 minutes

🎯 Project: Take five existing notes and weave them into a small connected web, then explore the backlinks that appear.

In This Lesson

Why Links Are the Whole Point

In Lesson 1.1 we said Obsidian rests on three big ideas, and that the middle one — links that build a web — is the magic ingredient. This is the lesson where that stops being a slogan and becomes something under your fingers.

Here's the mental model. Think of your notes as rooms in a house. In most note apps, the only way to get from one room to another is to walk back out to a hallway (a folder list), scan for the door you want, and walk in. A link is different: it's a doorway cut directly between two rooms. You're reading a note about "sleep," you see the word "caffeine" as a link, you click, and you're instantly in your caffeine note — no hallway, no searching. Cut enough of these doorways and your notes stop being a filing cabinet and become a living map of your own thinking.

And here's the part that surprises everyone: the doorways work in both directions automatically. Link note A to note B, and note B quietly grows a list of "everything that points at me." You never maintain it. You link forward; Obsidian builds the map backward for free. That two-way magic is what the second half of this lesson is about.

🧠 Mindset

If you've spent years perfecting folder structures, linking can feel like giving up control — like throwing your notes into a pile. It isn't. You're trading a rigid order (one note, one folder, forever) for a rich one (one note, many connections, growing over time). You don't have to link everything, and you don't have to get it right the first time. Every link you add makes the note easier to rediscover later. There is no wrong link — only more or fewer doorways.

Making Your First Link with [[

The whole syntax is two square brackets. In the editor, type:

[[

The moment you type the second [, Obsidian pops up an autocomplete list of your existing notes. Start typing part of a note's name and the list filters down. Use the arrow keys (or your mouse) to pick one, press Enter, and Obsidian finishes the link for you, closing the brackets automatically. The result looks like this:

I finally understood [[Compound Interest]] after reading that chapter.

In Reading view (and in Live Preview once your cursor leaves the link), that renders as a clickable link reading Compound Interest. Click it and you jump straight to that note. That's it. That's the core feature the entire app is built around.

✅ Pro Tip — you're already searching

The autocomplete is fuzzy: typing [[comp int will happily find "Compound Interest." You don't need to remember exact titles or capitalization. Linking is searching your vault, which is why fast, generous linking beats meticulous filing.

A few things worth knowing right away:

  • Links use the note's name, not its folder path. [[Compound Interest]] works no matter which folder that note lives in. You can move notes between folders later and the links keep working — Obsidian updates them for you.
  • Case-insensitive matching. [[compound interest]] and [[Compound Interest]] point to the same note.
  • Two link formats exist. By default Obsidian uses these [[wikilinks]]. There's also a setting to use standard Markdown links ([text](note.md)) instead, but wikilinks are the Obsidian-native experience and what this course uses throughout.
⚠️ Important Note: An internal link (a [[wikilink]]) points to a note inside your vault. It is not the same as a web link (https://…) or a Markdown link to an outside page. Both are useful, but only internal links build the web of ideas and feed the backlinks system.

Aliases, Heading Links & Block Links

Basic links get you 80% of the value. These three refinements get you the rest, and they're what make your writing read naturally instead of like a wiki.

🔤 Display text with the pipe: [[Note|alias]]

Sometimes the note's title doesn't fit your sentence. Your note is titled "Compound Interest," but you want the sentence to read "…the way interest compounds over time." Use a pipe character (|) to set the visible text without changing where the link points:

…the way [[Compound Interest|interest compounds]] over time.

That still links to the "Compound Interest" note, but the reader sees "interest compounds." This is called an alias or display text. Use it constantly — it's the difference between prose that flows and prose that reads like a database.

💡 Two kinds of "alias" — don't confuse them

The pipe alias above is a one-off display name for a single link. That's different from a note's permanent aliases property (the YAML aliases: field from Lesson 2.3 / Module 2), which makes a note findable under several names in the autocomplete. They work together beautifully: give a note a permanent alias, and you can link to it by that alias anywhere.

🧭 Linking to a heading: [[Note#Heading]]

You can point a link at a specific heading inside a note, not just the top. After the note name, type # and the autocomplete will offer that note's headings:

See [[Home Buying#Closing Costs]] for the fee breakdown.

Click it and you land on the "Closing Costs" heading, already scrolled into view. You can even chain down through subheadings: [[Note#Heading#Subheading]]. This is perfect for long reference notes where you want to send someone (or future-you) to an exact spot.

🎯 Linking to a block: [[Note#^blockid]]

The finest-grained link of all points to a single block — one paragraph, one list item, one quote. Here's the elegant part: you don't create block IDs by hand. While typing a link, after the note name type #^ and Obsidian shows you the blocks in that note to pick from. When you choose one, Obsidian silently stamps a little identifier onto that block in the target note, like ^a1b2c3, and wires your link to it:

That objection is answered here: [[Meeting Notes 2026-09-10#^k3f9x1]]

And in the target note, the block quietly gains its tag at the end of the line:

We agreed to ship the beta before the conference. ^k3f9x1

You'll rarely type that ^k3f9x1 yourself — you generate it by linking. Block links are fantastic for pointing at one specific sentence buried in a long note, and they become even more powerful when combined with embeds (which you met briefly in Module 2): ![[Note#^blockid]] pulls that exact block into another note, live.

⚠️ Watch Out

Heading links break if you rename the heading — the text after # no longer matches. Block links are sturdier because the ^id stays attached to the block even if you edit the surrounding words. If you find yourself relying on a link to survive edits, prefer a block link over a heading link.

You want to… Syntax Reader sees
Link to a note [[Compound Interest]] Compound Interest
Link but show different text [[Compound Interest|interest compounds]] interest compounds
Link to a heading inside a note [[Home Buying#Closing Costs]] Home Buying > Closing Costs
Link to a single block [[Meeting Notes#^k3f9x1]] Meeting Notes (jumps to that block)
Embed a note or block inline ![[Compound Interest]] The whole note/block, rendered in place

Ghost Links & "Link First, Create Later"

Here's a feature that feels strange for about ten seconds and then reshapes how you take notes forever.

You can link to a note that doesn't exist yet. Type [[Stoicism]] when you have no note called "Stoicism," and Obsidian accepts it happily. The link renders in a dimmer, muted style — this is an unresolved link, affectionately called a "ghost" note. It's a promise of a note, not yet a note.

What happens when you click it? Obsidian creates the note on the spot and drops you into it, ready to type. The ghost becomes real the moment you decide it should. Until then it costs nothing and clutters no folder.

📖 Why this changes everything: "link first, create later"

Old habit: "I should make a note about Stoicism… but where should it go? What should I call it? Ugh, later." — and the idea evaporates. New habit: while writing about anything, you just drop [[Stoicism]] in the flow of your sentence and keep going. You've now marked the idea as worth a note without breaking your thought. Later — maybe today, maybe in a month — you click that ghost and fill it in, right when you actually have something to say. You capture the intention instantly and defer the work to when it's cheap.

There's a second gift hiding here. Even before you create the ghost note, it already has backlinks. Every place you typed [[Stoicism]] is pointing at that future note. So when you finally open it, it arrives pre-loaded with context: "here are the three times past-you thought this mattered." You're never staring at a blank page — the note tells you why it exists.

⚠️ Important Note: Because ghost links create notes on click, be a little careful with spelling and naming. [[Stoicism]] and [[Stoic Philosophy]] are two different ghosts and will become two different notes. If you want them to be one, pick a consistent name (or use the note's aliases property so multiple names resolve to it).

✅ Pro Tip — find your ghosts

Curious which ideas you keep gesturing at but never wrote up? Ghost notes surface in the Graph view (next lesson) as faded, often-connected nodes, and Obsidian tracks unresolved links so you can hunt them down. A note that ten other notes point to but that doesn't exist yet is practically begging to be written — that's your vault telling you what's important to you.

Backlinks, Unlinked Mentions & Outgoing Links

You've been building doorways in one direction. Now meet the panes that reveal them in the other — the payoff for all that linking.

🔗 The Backlinks pane (linked mentions)

Open any note and look for its Backlinks pane. Depending on your setup it appears in the right sidebar, or as a section at the bottom of the note (there's a setting, "Backlinks in document," that pins it under the note itself). It answers one question: "Which notes link to this one?"

These are called linked mentions. For each note that points here, Obsidian shows the note's name and the actual sentence the link sits in, so you get instant context without opening anything. Open your "Compound Interest" note and the Backlinks pane might show:

Linked mentions (3)

  • Investing Basics — "…this only works because of compound interest…"
  • Why I'm Here — "I want to finally understand compound interest."
  • Book: The Psychology of Money — "Chapter 4 is really about compound interest."

You did nothing to build that list. You linked toward Compound Interest from three notes, and the backlinks appeared on Compound Interest automatically. This is the two-way magic from Section 1, made visible. Over time this pane becomes the single best reason to open a note: it shows you every context the idea has ever appeared in.

👻 Unlinked mentions

Below linked mentions, Obsidian offers unlinked mentions: places where the note's name appears as plain text but was never turned into a link. Maybe you wrote "compound interest" in an old note before you had a note for it. Obsidian spots the phrase and offers a one-click "Link" button to convert that mention into a real link (there's usually a "Link all" option too).

This is how you retroactively weave old notes into your web. Write a new note on a topic, then scroll its unlinked mentions and link the good ones — suddenly a year of scattered notes all point to your fresh hub. It's one of the most satisfying five-minute jobs in Obsidian.

⚠️ Watch Out

Don't reflexively "Link all." Unlinked mentions are matches on the words, so a note named "Apple" will match every mention of the fruit and the company. Skim before you link, and link only the mentions that genuinely mean the same thing. A few wrong links quietly pollute your web.

➡️ The Outgoing links pane

The mirror image of backlinks is Outgoing links — a pane (a core plugin you can enable) that lists every note this note points to. Backlinks answer "who points at me?"; outgoing links answer "who do I point at?" Together they give you a note's complete neighborhood at a glance, and outgoing links even flag ghost links so you can see which of this note's connections are still unwritten.

👁️ Hover Page Preview

One more everyday delight. With the core Page preview plugin on, hover your cursor over any internal link (on desktop, often while holding a modifier key like Ctrl/⌘, configurable in settings) and a little popup shows that note's contents without leaving where you are. You can peek at a linked note, confirm it's the right one, and keep reading — the doorway opens just a crack. This works in the Backlinks pane too, so you can survey a note's whole web by hovering.

graph LR IB["📄 Investing Basics"] --> CI["💰 Compound Interest"] WIH["📄 Why I'm Here"] --> CI PM["📘 The Psychology of Money"] --> CI CI --> RISK["📄 Risk & Reward"] CI --> STOIC["👻 Stoicism (ghost)"] style STOIC stroke-dasharray: 5 5

Three notes link into Compound Interest (its backlinks); Compound Interest links out to two more — one of them still a ghost.

Links vs. Folders: The Deep Idea

We keep hinting that "links beat folders." Now that you can actually link, let's make the case properly, because internalizing this changes how you build your whole vault.

A folder forces a single choice. A note about "my caffeine experiment" has to live in one folder. Is it under Health? Experiments? Sleep? Productivity? It honestly belongs in all four — but a folder makes you pick one and, in doing so, hides it from the other three contexts. Every time you file a note, you're quietly deciding which future searches will fail.

A link adds a context without removing any. That same note can be linked from your Health MOC, referenced in your Sleep note, mentioned in a Productivity log, and cited in an Experiments index — all at once. It lives in many places because ideas genuinely do. Your brain doesn't file "caffeine" in one drawer; it fires connections to coffee, sleep, that article, your afternoon crash, and a friend's advice all at the same time. Links let your notes work the way your mind already does.

Folders Links
A note can belong to… Exactly one place As many contexts as you like
Adding a new connection Means moving/copying the note Just type [[ — the note stays put
Shows relationships No — a folder is a container, not a link Yes, and both directions (backlinks)
Rediscovery Only if you remember the right folder Any linked note is a doorway back to it

💡 This is not "folders are bad"

Folders still have real jobs — separating big life areas, holding attachments, keeping templates tidy. The point isn't to delete your folders; it's to stop using them as your primary way of relating notes. Let folders be shelves and let links be the meaning. In Lesson 3.3 you'll learn Maps of Content — hand-built hub notes that use links to organize a topic far more flexibly than any folder tree could.

"The value of your vault is not in the notes. It's in the links between them." A pile of 500 unconnected notes is a junk drawer; 500 well-linked notes is a mind you can think with.

🎯 Project: Weave a Web of Five Notes

Time to feel the whole loop for yourself: link forward, watch backlinks appear, meet a ghost, and use a heading link. If you don't have five notes yet, spend two minutes making quick stubs (a sentence each) on any topics you care about.

🏋️ Build a small connected web

Objective: Turn five standalone notes into a little network and explore the connections Obsidian builds for you.

Instructions (about 20 minutes):

  1. (3 min) Pick or create five notes that are loosely related — say Sleep, Caffeine, Focus, Morning Routine, and a book or article note. Give each one a real title.
  2. (5 min) In each note, add at least one link to another of the five using [[ and the autocomplete. Where a note's title doesn't fit your sentence, use an alias: [[Caffeine|that afternoon coffee]].
  3. (3 min) In one note, add a heading (e.g. ## Key idea) and, from a different note, link straight to it: [[Sleep#Key idea]]. Click it to confirm you land on the heading.
  4. (2 min) Deliberately type one ghost link to a note that does not exist yet — something you'd like to write later, like [[Sleep Hygiene]]. Notice its faded style. Don't create it yet.
  5. (4 min) Open one of the five notes and study its Backlinks pane. Which notes point here? Read the sentence context shown for each. Then check Unlinked mentions — is there an old plain-text mention you can "Link" with one click?
  6. (3 min) Finally, hover a link (with Page preview) to peek at the target, then click your ghost link to bring Sleep Hygiene into existence — and notice it already shows a backlink to where you dropped it.
💡 Hint — what a linked note looks like 
# Caffeine

Coffee is my main lever for [[Focus]] in the morning, but it wrecks my
[[Sleep|sleep quality]] if I have it after 2pm. See [[Sleep#Key idea]] for
the mechanism. I still need to write up [[Sleep Hygiene]] properly.

Related reading: [[Book - Why We Sleep]]

Five links, four of them to real notes, one ghost — and every note named here just gained a backlink to "Caffeine."

🧩 Stuck? A step-by-step for the heading link
  1. Open the Sleep note and add a line: ## Key idea, then a sentence under it.
  2. Go to Caffeine. Type [[Sleep — then type #.
  3. The autocomplete now lists Sleep's headings. Pick Key idea and press Enter.
  4. You'll have [[Sleep#Key idea]]. Click it to jump to that exact heading.

✅ Project Completion Checklist

  • All five notes contain at least one working internal link
  • At least one link uses an alias (the | pipe)
  • At least one link points to a heading (#)
  • You created and then clicked a ghost link to make a new note
  • You read a note's Backlinks pane and understood the linked mentions
  • You spotted (and maybe converted) at least one unlinked mention

🎯 Quick Quiz

Question 1: What does [[Home Buying|closing costs]] do?

Question 2: You type [[Stoicism]] but have no such note. What happens?

Best Practices for Linking

✅ Do's

  • Link generously and in the flow. If a concept has its own note (or should), link it as you write. Don't stop to think about folders.
  • Use aliases for readable prose. Bend the display text to your sentence, not the other way around.
  • Trust ghost links. Drop links to notes you haven't written; let your future self fill them in with context already waiting.
  • Check backlinks before you write. A note's backlinks tell you what it's for.

❌ Don'ts

  • Don't over-link every word. If everything is a link, nothing stands out. Link the concepts that deserve their own note, not every noun.
  • Don't "Link all" unlinked mentions blindly. Same word, different meaning, will create bad connections.
  • Don't create ghosts with inconsistent names. "JS," "JavaScript," and "Java Script" become three notes. Pick one; use aliases for the rest.

📓 Learning Journal

Open your learning-journal note in your vault and, after this lesson, jot down:

  • Key concepts you learned
  • Techniques that clicked for you
  • Questions or confusion points to revisit
  • Ideas you want to try
  • Your progress and feelings about learning this

✍️ This lesson's prompt: Open the note in your vault with the most backlinks so far. What surprised you about the contexts it appears in? Then name one ghost link you created — which idea are you promising future-you that you'll write up, and why does it matter to you? (And yes — link this journal entry to at least one note you touched today.)

📝 Lesson Summary

🎓 Key Takeaways

  • Create internal links by typing [[ and using the autocomplete; links use the note's name, not its folder.
  • Refine links with aliases ([[Note|text]]), heading links ([[Note#Heading]]), and block links ([[Note#^id]], where the ^id is generated for you).
  • Ghost links let you link to notes that don't exist yet and create them on click — enabling the powerful "link first, create later" workflow.
  • Backlinks (linked & unlinked mentions) and Outgoing links reveal a note's full web automatically — you link one way, Obsidian builds the map both ways.
  • Links beat folders because a note can live in many contexts at once, the way ideas really do.

🎉 What You've Accomplished

You just learned the skill that separates a "notes app" from a "second brain." You can connect ideas, read the connections Obsidian surfaces for you, and capture future notes without breaking your flow. From here on, every note you write can strengthen the ones around it. Your vault has stopped being a list and started becoming a web.

❓ Common Questions at This Stage

If I rename or move a linked note, do my links break?

No — Obsidian automatically updates every link to a note when you rename or move it (this is on by default). That's a huge advantage over hand-typed file paths. The one thing to watch is heading links: if you rename a heading, links pointing at that heading text won't follow. Block links (^id) survive edits better.

Should I link a note or just tag it?

Both are connections, but they feel different. A link ties two specific notes together and creates a backlink you can read in context — great for "this note relates to that note." A tag groups many notes under a label — great for "show me everything about #project." A common pattern: tags for broad categories and states, links for actual relationships. You already met tags in Module 2; you'll blend the two throughout the course.

What's the difference between a link [[Note]] and an embed ![[Note]]?

A link is a doorway you click to go to the note. An embed (the leading !) pulls the note's content into the current note and displays it inline — live, so it updates if the source changes. Embeds are perfect for reusing a definition, a diagram, or a single block in several places without copy-pasting. We lean on embeds more in later modules.

🔭 Looking Ahead

You've been linking notes and reading backlinks one note at a time. In the next lesson we zoom all the way out: the Graph view shows your entire web at once as a constellation of dots and lines. You'll see your clusters, spot lonely orphan notes, and learn to read the map you've been quietly drawing.

✅ Before the Next Lesson

  • Finish the five-note web project — you'll want real links to look at in the graph
  • Create at least two ghost links you intend to fill in later
  • Make sure the Backlinks (and, if you like, Outgoing links) core plugin is enabled
  • Write your Learning Journal entry for this lesson

📚 Additional Resources

🌟 Encouragement for the Journey

Take a second to appreciate what just happened: you cut your first real doorways between ideas, and Obsidian answered by showing you connections you'd forgotten you made. That feeling — "oh, these two things are related" — is the whole reason this app exists. Keep linking. Every doorway you build today makes your future thinking faster. Onward to the graph. 🔮