Wikilink Integrity

Obsidian resolves [[Target]] by looking for a note whose basename is Target.md anywhere in the vault. Links break silently when a note is renamed, moved, or was never created. Ambiguity arises when two notes share a basename.

Link Syntax

[[Note Name]]                      # basename resolution
[[Note Name|Alias]]                # custom display text
[[Note Name#Section heading]]      # deep link to heading
[[folder/Note Name]]               # path-qualified (usually unnecessary)
![[Image.png]]                     # embed (image, note, PDF)

Resolution Rules

1. Unqualified target ([[Docker]]) resolves to any note with basename Docker.md. If two exist (e.g. Zettelkasten/Docker.md and FVH/z/Docker.md), Obsidian picks one non-deterministically — ambiguous.
2. Path-qualified target ([[Kanban/Main]]) resolves to Kanban/Main.md exactly — no basename fallback.
3. Embeds (![[X]]) follow the same resolution. Image embeds typically target files under Files/.