Download
  1. Docs
  2. Writing and linking

Linking notes

Connect notes with wikilinks, aliases, heading and block links, embeds and tags, and how Scaffold resolves and updates them.

On this page

Links are what turn a pile of notes into a body of knowledge. Scaffold supports the familiar wikilink syntax as well as standard Markdown links, and keeps both working when you rename or move files.

Wrap a note title in double brackets:

See [[Atomic ideas]] for the longer version.

Variations:

You write It does
[[Atomic ideas]] Links to the note named Atomic ideas.
[[Atomic ideas|the short version]] Shows your own text, links to the same note.
[[Atomic ideas#Examples]] Links to a heading inside the note.
[[Atomic ideas#^quote-1]] Links to a single block that has an id.
![[Atomic ideas]] Embeds the note’s content in place. Images and PDFs embed the same way.

Autocomplete

Type [[ and Scaffold searches your vault as you type. The suggestions include notes, their aliases, headings and blocks, and a Create entry when nothing matches. Subfolder paths are shown under each result so two notes with the same name are easy to tell apart. Try a small version of it on the home page.

Scaffold tries, in order:

  1. An exact path, such as Projects/Trail map.
  2. A file with that name anywhere in the vault.
  3. If several files share the name, the one with the shortest path wins, and the link is marked ambiguous so you can spot it.

Matching ignores letter case. A link that matches nothing is shown in a muted style, and clicking it offers to create the note.

Rename or move a note and Scaffold rewrites the links that point to it, in the same operation. You see a preview of what will change before you confirm. Turn this off per vault if you prefer to manage links yourself. See Vaults.

You can also write [text](Note.md). Choose the link format used for new links in the vault settings: wikilinks (default) or Markdown links. Both are understood everywhere, and your files stay readable in any editor either way.

Tags

Write #idea anywhere in a note, or list tags in the properties. Tags nest: #project/alpha also matches a search for project. The tags panel lists every tag in the vault with counts. See Search for filtering by tag.

  • Backlinks show the other direction of every link.
  • The graph draws all links at once.