A wiki link is a link to another note written with double square brackets, like [[Project ideas]]. A backlink is the automatic reverse link: every note that points at the note you are reading.
If you have used Wikipedia, you already know the idea: words link to other pages. Wiki links bring that to your own notes. A backlink is the reverse view: a list of every note that points at the note you are reading. Together they let you organize notes by how ideas relate instead of by which folder they sit in. This guide explains both, shows a worked example, and gives you a routine you can start this week.
Wiki links
A wiki link is a link to another note, written by wrapping the note’s title in double square brackets. You do not type a file path or a URL, only the name of the idea.
I should revisit [[Slow software]] before the essay.
The text [[Slow software]] becomes a link to the note titled “Slow software”. Because you type the title and keep going, linking costs a second or two and you never leave the keyboard.
Wiki links are different from ordinary markdown links. A standard markdown link looks like [label](https://example.com) and points at an address. A wiki link points at another note by name. If you want the full syntax for standard links, images and formatting, the markdown cheat sheet covers it.
Backlinks
A backlink is the other direction. Open “Slow software” and you see every note that links to it. You do not maintain this list by hand; the app builds it for you from the links you already wrote.
This is the part that makes linking worth the effort. A normal link only helps you when you are standing on the note that contains it. A backlink helps you from the destination. When you open an idea, you see everywhere you have already used it, including notes you forgot you wrote.
Outgoing links versus backlinks
| Aspect | Outgoing link | Backlink |
|---|---|---|
| Who writes it | You, by typing [[Title]] | The app, automatically |
| Where it appears | Inside the note that mentions the idea | On the note being mentioned |
| Answers the question | “What relates to this?” | “Where have I used this?” |
Why backlinks matter
- Rediscovery. Old notes resurface when you write something related, because the new link puts them on the page.
- Structure without folders. A note can only live in one folder, but it can be linked from a dozen places. Links describe how ideas relate, which folders cannot.
- Thinking. Deciding that two notes belong together is the work of understanding. The link is a small record of that decision.
- Low maintenance. There is no index to update. The reverse list stays correct as you write.
A worked example
Here is a small set of notes, written the way you might actually write them. Each one is short and holds one idea.
# Slow software
Software that respects attention: few notifications, quiet defaults,
no streaks. Related: [[Calm interfaces]], [[Local-first]].
#design
# Calm interfaces
A calm interface shows less and asks for less. Good example of the
limits of [[Slow software]]: calm is not the same as sparse.
#design
# Local-first
Data lives on your own machine first, and sync is optional.
Supports [[Slow software]] because it works offline and instantly.
#principles
Now open “Slow software”. Its outgoing links are “Calm interfaces” and “Local-first”. Its backlinks are the same two notes, because each of them mentions it. Six months later you write an essay and open only “Slow software”; the whole cluster is one click away, with the context you wrote at the time.
Notice what the notes do not have: no folder called “Design” and no folder called “Principles”. The tags give broad grouping, and the links give the specific connections.
Wiki links versus tags
Both connect notes, but they do different jobs. Use the one that fits the question.
- Tags such as
#designanswer “what broad topic is this?” They are good for filtering a large pile of notes down to a theme. - Wiki links answer “which specific note does this relate to, and why?” They carry a sentence of context around them.
A simple rule: if you would be happy browsing everything on the topic, use a tag. If you are pointing at one particular idea, use a link.
How to start
- Write short notes with one idea each. Long notes are hard to link to because they say too many things.
- Give each note a clear, specific title. The title is what you will type inside the brackets, so “Slow software” beats “Thoughts 3”.
- Link generously with
[[...]]whenever one idea relates to another. - Write one sentence of context around each link, so future you knows why the connection exists.
- Use
#tagsfor broad topics and links for specific connections. - Review backlinks when you revisit a note.
A five-minute weekly routine
- Pick the three notes you touched most this week.
- Open each one and read its backlinks. Ask whether any surprising note appears.
- Add one new link from each note to something it now clearly relates to.
- Find one note that has no links in or out. Either link it to something or decide it does not belong and move it to the trash.
Over a few weeks this habit does more than any reorganizing session, because the structure grows out of the way you actually think.
Common mistakes
- Vague titles. Generic titles like “Ideas” collect unrelated backlinks and tell you nothing.
- Linking everything to everything. A link should mean “these two are meaningfully related”. If every note links to one hub, the backlinks stop being useful.
- Links with no context. A bare list of
[[links]]is hard to read later. Add a few words about the relationship. - Renaming casually. Because links use titles, changing a title can leave older links pointing at a name that no longer exists. Check how your app handles renames before you restructure a large set of notes.
- Using links instead of tags, or the reverse. Pick the right tool for broad versus specific connections.
Troubleshooting
- A backlink is missing. Check that the title inside the brackets matches the target note’s title exactly, including spelling and spacing.
- The same idea has two notes. Merge the text into one note and fix the links that pointed at the other.
- Too many backlinks on one note. That note is probably too broad. Split it into narrower notes and link between them.
When not to use wiki links
Links are not always the right tool. A one-off shopping list, a meeting scratchpad or a throwaway draft does not need connections, and forcing them adds friction. Links also do little for content you will never revisit. Use them for ideas you expect to build on: research, writing, projects and long-running questions.
Using wiki links in atiea
atiea supports [[wiki links]] and shows backlinks, so your notes connect as you write. It is a native Mac app with a live-highlighted markdown editor, and notes are stored locally on your Mac, with no account required. See the markdown editor for Mac page for the writing experience, or read how to take notes in markdown for the basics.
If you are coming from another tool, the Obsidian alternative page compares approaches; check each product’s site for current details. For a method built entirely on small linked notes, read Zettelkasten for beginners, and for unfamiliar terms see the glossary.