Wikilinks and backlinks
A wikilink connects one note to another by name, not by path. You do not have to remember where a note lives, and moving it does not turn the link into a dead path.
Writing one
Section titled “Writing one”Type [[ anywhere and a list of your notes appears beside the cursor,
narrowing as you type.
The decision is written up in [[Meeting 2026-09-01]].Step by step:
- Type
[[ - Start typing part of the note name — the list filters as you go
- Press Enter on the one you want
The closing ]] is written for you, and the menu closes as soon as the link
is finished.
Linking to a note that does not exist yet
Section titled “Linking to a note that does not exist yet”Click a link to a note you have not written yet and mdai asks Create this
note?. A plain name is made in the folder you are writing in, so the
link you just wrote is the link that resolves; a name with a path, such as
[[folder/x]], is made at that path from the top of the vault. That is the whole point: you write the sentence
first and the file follows.
When you rename a note, mdai offers to update the [[links]] that point at it,
and changes them only after you confirm.
Following one
Section titled “Following one”Click a [[link]] and the note opens in the editor. ⌥-click it (Alt-click on
Windows and Linux) to open the note in the other pane of
split view. What you clicked is plain
text in your file — exactly what you would have typed by hand — and what
opens is an ordinary .md file sitting next to the others.
Embedding a section or a block
Section titled “Embedding a section or a block”Put ! in front of a link to a heading or a block, and its text is shown right
inside your note:
![[Project plan#Goals]]![[Project plan#^budget]]#Goalsshows that heading and everything under it, up to the next heading of the same level. Letter case does not matter.#^budgetshows one block — the paragraph, list item or other block in the original that ends with^budget.- Change the original, save it, and every embed of it shows the new text, also in notes that are already open.
- Click the embed to open the original at that heading or block.
- If the note, heading or block doesn’t exist, the embed says so. A note you haven’t saved yet asks to be saved first.
- Source Code mode shows the embedded text as well.
The file keeps exactly the line you wrote, ![[Project plan#Goals]], so other
editors see an ordinary link.
Backlinks — what points at this note
Section titled “Backlinks — what points at this note”View → Toggle Backlinks opens the Backlinks panel. It lists the notes
that link to the one you are reading by its name, as in [[Note]] (links
written with a folder path are not listed yet), with the sentence around the
link and the file it came from. Click an entry and that source note opens.
This means a note tells you what refers to it without you keeping any index by hand. You write links in one direction; you can read them in both.
Unlinked mentions — the ones you never bracketed
Section titled “Unlinked mentions — the ones you never bracketed”Below the backlinks sits a second section: Unlinked mentions. These are the places where this note’s name appears in your prose as plain words, with no brackets around it.
Each mention has a Link button. One click turns
We agreed this in the Meeting 2026-09-01 write-up.into
We agreed this in the [[Meeting 2026-09-01]] write-up.The rest of the sentence is untouched — only the name gets its brackets.