Links turn separate notes into a connected body of work. In Notez you make one by typing two square brackets.
Create a link
Type [[ anywhere in the editor. A menu appears:
With nothing typed, it offers your recent notes
Keep typing to search
Pick a note and it is inserted as a link chip
If the note does not exist yet, the menu offers Create "your title" — it creates the note and links to it in one step, so you never break your writing flow to go set something up.
Two details worth knowing: [[ is ignored inside code blocks and inline code, so code samples containing brackets are safe. And typing ]] cancels the menu.
You can also link with @. Its menu, which also adds reminders and mentions, has a Notes section listing your recent notes, or the ones matching what you type. A note picked there goes in as the same link chip, with the same backlink. @ has no Create row, so a note that does not exist yet still needs [[.
In the search box and a board column's Add note box, @ offers the same notes, and the link goes into the body of the note you create. See Quick capture and bookmarks.
Backlinks are automatic
Link note A to note B and B immediately knows about A. You never maintain the reverse direction.
The Linked notes panel
Below each note, Linked notes shows the connections with a count. Each row carries a badge for its direction:
Badge | Meaning |
|---|---|
Out | This note links to that one |
In | That note links here |
Both | They link to each other |
Empty state: "No linked notes yet — type [[ in the editor to link a note."
Relation-type custom properties also appear here, so a Client or Project relation shows up alongside links you typed by hand.
List view and graph view
Toggle between List view and Graph view. Your choice is remembered.
List view shows rows you can sort, and filter by custom property.
Graph view draws this note at the centre with its connections radiating out, colour-coded by direction, with arrowheads showing which way each link points. The legend reads Outgoing, Incoming, and Both directions.
What the graph does: hovering highlights a node and dims the rest; clicking any outer node opens that note as a full page.
What it does not do: there is no zoom, pan, or dragging, and it shows one hop only — the notes directly connected to this one, not the whole workspace. It is a local map, not a full knowledge graph. Long titles are truncated.
The sort and property filter apply to the list only; the graph ignores them.
Renamed and deleted notes
Rename a note and every chip pointing at it updates automatically. Links resolve the live title, so nothing goes stale.
Delete a note and chips pointing at it render greyed and struck through, no longer clickable, with the tooltip "This note was deleted". The chip stays in your text rather than vanishing and leaving a hole in a sentence.
Links are re-derived every time you save, and when you restore an earlier version, so deleting a chip from your text also removes the backlink on the other side.
Links only resolve within the same workspace. You cannot link across workspaces.
Links vs. Similar Notes
Notez has two connection systems, and they complement each other:
Linked notes — explicit, created by you with
[[or@. Records connections you know about.Similar Notes — automatic and semantic, requiring nothing from you. Surfaces connections you do not know about.
Use links for deliberate structure — a project note linking its decisions. Let Similar Notes do the remembering for everything else.
AI chat and assistants connected over MCP can read both: ask "what links to this note?" for its links and backlinks, relations included, or "which notes are similar to this one?".
On shared notes
If you share a note publicly, links inside it pointing to notes you have not shared show as unavailable to visitors. Sharing one note never exposes the notes it links to.