Skip to content

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.

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:

  1. Type [[
  2. Start typing part of the note name — the list filters as you go
  3. Press Enter on the one you want

The closing ]] is written for you, and the menu closes as soon as the link is finished.

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.

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.

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]]
  • #Goals shows that heading and everything under it, up to the next heading of the same level. Letter case does not matter.
  • #^budget shows 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.

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.