Flints
Sign in

How [[Wikilinks]] Work

A wikilink is a link you write with double brackets — [[ ]] — that connects two notes without ever leaving your keyboard. Type [[ and a note title, and Flints turns it into a real connection between your notes.

Most note apps give you folders. Folders are fine until an idea belongs to more than one place. A wikilink doesn't force you to choose — it just draws a line between two notes and lets that idea live wherever it's relevant.

How to write one#

In any note, type [[ followed by the note title, then close it with ]]: This is connected to [[Second Step]]. That's it. The link is saved the moment you stop typing.

What happens under the hood#

When a note is saved, Flints scans its content for [[Title]] and records three things about every link:

Piece What it means
Outgoing link Notes your note points to
Incoming link (backlink) Notes that point to your note
Link map The local graph of everything connected to the current note

Open a note and scroll to the bottom: the Link Map draws these connections as a graph, so you can see the shape of your thinking — not just a list.

A few tips#

  • Rename safely. If you rename a note, Flints keeps its backlinks pointing at the new name, so nothing silently breaks.
  • Follow your curiosity. Reading a note, click any [[link]] in the text to jump straight to it.
  • Keep names unique. Links match by title, so giving two notes the same title creates ambiguity. A little specificity goes a long way.
  • Let orphans stay. Notes with no links aren't a mistake — they're unfinished thoughts waiting to be wired in later.

Try it now#

Open the workspace and type [[ in any note. The fastest way to understand wikilinks is to connect two of your own ideas.

More from the blog