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.

In chat and agents

Citations from chat answers are real refs — clicking one opens the source document. Agents can resolve refs via MCP when reading documents.