← All guides

Linking notes

Links are what turn a pile of notes into a body of knowledge. In Nodes you make them inline, as you write, with the familiar double-bracket syntax.

To link to another note, write its name in double brackets:

I built on the idea from [[Spaced Repetition]].

As you type inside the brackets, Nodes suggests matching notes; click one to insert the link without retyping its full name - or move through the list with the up and down arrows and press Return to pick the highlighted note. Press ⌘Return instead to link and jump straight to that note. The link becomes a real connection between the two notes - not just blue text.

You can link to a note that doesn't exist yet, too. The link is ready the moment you create that note. If nothing matches what you've typed, the list offers Create “Spaced Repetition” - click it to make that note and link to it in one go. A link you leave as typed stays dimmed until a note with exactly that name, capitals included, exists.

Click a link to open the note it points to. To edit the link instead, click at its very start or end - the caret lands just outside the brackets.

You can follow links the other way, too. The Links section of the Node Inspector (⌘I) lists every note this one links to under OUTGOING, and every note that links here under INCOMING. Click any of them to open it.

Renames just work

Rename a note and Nodes updates every link to it that you made from the list, so a tidy-up never leaves a trail of broken references behind. A link you typed out in full without picking a note points at the name alone, and it stops working once that name changes - so pick from the list whenever you can. You're free to rename things as your thinking sharpens.

Why it matters

Every link you make is also an edge in your graph. The more you connect, the more the shape of your ideas becomes something you can actually see and explore - clusters of related thought, bridges between topics, notes that quietly tie everything together.

Linking is the single habit that gets the most out of Nodes. When in doubt, link it.