Links between notes
Wrap a note’s name in double brackets to link to it. Links are plain text in the file, so they work in any editor and in git.
Linking to a note
Section titled “Linking to a note”Type [[ in insert mode. The note picker opens: type a few letters and press Enter to finish the link. To link to a note that doesn’t exist yet, type its name and press Enter when nothing matches.
Learn more about [[Docker]].To follow a link, click it in the preview, or put the cursor on it in NORMAL mode and press gd (or gx).
A link to a note that doesn’t exist yet is dimmed. Following it opens a new note with that name; nothing is written until you save it.
Names are matched without caring about case, and a note in the same folder
wins when two notes share a name. Use a path to be exact:
[[Projects/AWS]].
Linking to a heading
Section titled “Linking to a heading”Add # and the heading to open the note at that section:
[[AWS Notes#S3 Storage]]Show your own text instead of the note’s name with |:
[[AWS Notes#S3 Storage|Learn about S3]]The preview shows Learn about S3; the link still goes to the S3 Storage
heading. [[#Setup]] links to a heading in the same note.
Linking to a block
Section titled “Linking to a block”To point at one paragraph or list item, give it an id by ending the line
with a space, ^ and a name:
S3 stores objects in buckets. ^s3-basicsThen link to it with #^:
[[AWS Notes#^s3-basics]]The preview hides the ^s3-basics marker.
Embedding
Section titled “Embedding”Put ! in front of a link, on a line of its own, to show the linked note
right there instead of a link to it:
![[AWS Notes]] the whole note![[AWS Notes#S3 Storage]] one section![[AWS Notes#^s3-basics]] one block![[diagram.png]] an image from anywhere in the workspaceEmbeds always show the latest version of the note, and its header is a link to it. When you export to PDF, embeds are printed in full.
Backlinks
Section titled “Backlinks”The bottom of every note’s preview lists the notes that link to it, under Linked from, with the line that holds the link. Click one to open that note at the link.
To see links and backlinks together, open the graph.
Web links and files
Section titled “Web links and files”Standard Markdown links work too:
[GitHub Repository](https://github.com)<https://github.com>[the plan](projects/plan.md#timeline)Web addresses open in your browser. A link to another .md file opens that
note (at the heading after #), and links to other files open them with
their default app.
The Link to page entry in the / block menu inserts this kind of Markdown link to a note you pick.