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:

1. Exact match — if a note named Some Note exists anywhere in the vault, that's the target.
2. Path-disambiguated — [[Folder/Name]] is treated as a path-qualified wikilink when there are duplicates.
3. 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.

See also

• Backlinks
• Embeds