Refs

Refs are inline links between documents. They survive renames and show up as backlinks on the target.

Inserting a ref

Type @ in the editor. A picker opens with your documents — keep typing to filter, Enter to insert. The ref renders as the document’s title and stays linked even if you rename the target.

Ref syntax

Under the hood, a ref is ref:doc:<uuid>. You rarely need to see this — the editor handles it — but it’s stable across moves and renames.

Backlinks

Every document has a Backlinks tab showing every other document that refs it. Use it to trace what cites a given idea.

For agents

Refs travel as plain markdown, so agents reading a document over MCP see them and can follow them — search_documents returns the node ids refs point at.