Wiki Links
Basic Syntax
Wiki-links let you connect documents together using a simple double-bracket syntax:
[[Document Title]]
This creates a link to the document matching that title within your workspace. Wiki-links are rendered as clickable links in both the editor and shared views.
Display Text
You can customize the visible text of a wiki-link while still pointing to the target document:
[[Document Title|custom text]]
This renders as custom text but navigates to Document Title when clicked. Use this when the document title doesn't fit naturally into a sentence.
| Syntax | Renders As | Links To |
|---|---|---|
[[API Reference]] | API Reference | API Reference |
[[API Reference|the API docs]] | the API docs | API Reference |
[[Setup Guide|getting started]] | getting started | Setup Guide |
Autocomplete
Typing [[ in the editor triggers a search dropdown that helps you find documents in your workspace. As you continue typing, the list filters in real time. Select a document from the dropdown to insert the wiki-link automatically.
Autocomplete searches across all documents in your workspace, so you don't need to remember exact titles. Just start typing a keyword and pick from the suggestions.
Backlinks
Every document in Notery tracks its backlinks — a list of other documents that link to it. The backlinks panel appears in the document metadata sidebar, giving you a quick way to see how a document fits into your knowledge base.
Backlinks update automatically whenever you add or remove a wiki-link. There is nothing to configure.
Building a Connected Knowledge Base
Wiki-links are most powerful when used consistently across your workspace. Here are some practical patterns:
- Link related concepts. If your "Authentication" doc mentions JWTs, link to your
[[JWT Deep Dive]]document. - Reference architecture from implementation. Implementation notes should link back to the relevant
[[Architecture Overview]]or[[API Design]]docs. - Create hub documents. Build index-style documents (e.g.,
[[Project Index]]) that link out to all related docs for a project or topic. - Use backlinks for discovery. When you open a document and see unexpected backlinks, it can reveal connections you hadn't considered.