Oracle
Wikilinks
Soft, name-based links between notes — the heart of Oracle's connectivity model.
Updated 27 April 2026
oraclewikilinks
Wikilinks
A wikilink is the way you reference one note from another in Oracle. Unlike a hard URL, a wikilink targets a note by name — when the note is renamed or moved, every wikilink that points at it updates automatically.
Syntax
| Syntax | What it does |
|---|---|
[[Some Note]] | Plain link to "Some Note" |
| `[[Some Note | the hero]]` |
[[Some Note#Backstory]] | Link to a section heading |
[[Some Note#^abc123]] | Link to a block reference |
When you type [[ in the editor, Oracle pops up an autocomplete menu showing every note in the vault, ranked by recency.
Resolving links
Oracle resolves wikilinks at render time:
- Exact match — if a note named
Some Noteexists anywhere in the vault, that's the target. - Path-disambiguated —
[[Folder/Name]]is treated as a path-qualified wikilink when there are duplicates. - Unresolved — wikilinks to missing notes render in red and act as a "create new" button when clicked.
Best practice
- Prefer wikilinks over Markdown URLs for anything inside the vault. Renames Just Work.
- Use section anchors when linking to a specific subtopic — your reader lands exactly where you want.
- Block references (
#^id) are good for transclusion: you can quote a single paragraph from another note without copy-pasting.