Links between notes

Linking one note to another is what turns a pile of loose jottings into a network of ideas. Here you'll see how to create internal links between notes (the "wikilinks"), how to point a link at a specific section, and how to link to web addresses. Every internal link becomes part of the graph and of the Connections panel, so linking as you write pays off.

What is a link between notes

An internal link (wikilink) connects the note you're writing to another note in your collection. Instead of copying text or repeating an idea, you point to the note where it already lives, and the reader can jump straight there. It's the simplest way to keep each topic in one place and still reference it from wherever you need.

Unlike a web link, an internal link knows its target note: it follows the note's current title and icon, becomes a connection in the graph, and shows up as an incoming link on the other side.

Create a link with [[

1. 1At the point in the text where you want the link, type the two opening brackets: [[
2. 2The "Link note" menu appears. Start typing the title of the target note — the list narrows down (the search ignores accents).
3. 3Use the arrow keys to choose the note and confirm with Enter or Tab, or click it in the list.
4. 4The text becomes a clickable "chip": clicking it opens the target note in the editor.

Create the note and link it in one step

If the note you want to cite doesn't exist yet, there's no need to stop writing to create it first. When nothing matches what you typed, the menu shows "Enter — create the note … and insert the link": confirming creates the new note and inserts the chip pointing at it, ready to be filled in later.

Display text and section links

[[Title|alias]]

The chip displays the alias instead of the note title. The target and the graph still follow the real title — the alias is only what you see in the text.

[[Title#Section]]

After the #, the menu switches to "Link section" and lists the headings of the target note. The link then opens the note and scrolls straight to that section.

[[#Section]]

With an empty title, the link points to a section of the note you're writing in.

The link chip

Each internal link is shown as a chip — a small block with the target note's title. Hovering it opens a mini menu with the actions:

Open

Opens the target note in the editor (same as clicking the chip).

Change target

Points the link at another note without deleting and recreating the chip. The display alias, if any, is kept.

Remove link

Removes the link but keeps the title as plain text.

Other ways to link

• Drag a note from the list into the text: the chip is inserted exactly where you drop it.
• Typing or pasting a literal [[Title]] converts it automatically into a chip (except inside code).
• The editor's insert menu also offers "Link to note", with a search field ("Search notes…").

Duplicate titles and circular links

Picking a note in the menu links exactly the note you chose, even if another one has the same title. A literal [[Title]] typed in full, on the other hand, is resolved by title: with duplicates it always lands on the same note (a stable choice). Prefer unique titles — or pick from the menu — when names collide.

Links to web addresses

Besides linking notes to each other, you can turn a stretch of text into a link to an external page.

1. 1Select the text that should become the link.
2. 2Use the link shortcut or the link button in the formatting bar.
3. 3Enter the target web address (URL) and confirm.
4. 4To remove the link, open it again and clear the address — the text goes back to normal.

Where the links go