# Obsidian Wikilinks Wikilinks are [[Obsidian]]'s internal link syntax: `[[Note name]]`. They are the feature that turns a folder of Markdown files into a knowledge graph. Every wikilink you add creates a connection that [[Backlinks core plugin for Obsidian|backlinks]], the [[Obsidian Graph view]], and search can exploit later. ## Syntax ``` [[Note name]] Link to a note [[Note name|Display text]] Link with custom display text [[Note name#Heading]] Link to a specific heading [[Note name#^block-id]] Link to a specific block [[Folder/Note name]] Disambiguate notes with the same name ``` Typing `[[` triggers autocomplete across all note names and [[Obsidian Aliases|aliases]]. Renaming a note updates every wikilink pointing to it; this is what makes large-scale refactoring safe. ## Wikilinks vs Markdown links Obsidian also supports standard Markdown links: `[Display](Note%20name.md)`. Wikilinks are shorter and more pleasant to write, but they are Obsidian-specific. If portability to other Markdown tools matters, switch **Settings → Files and links → Use `[[Wikilinks]]`** off to generate Markdown links instead. The same settings pane controls the link resolution format (shortest path, relative, or absolute). ## Good to know - Links to notes that don't exist yet render as dimmed "unresolved" links; clicking one creates the note. Deliberate in some workflows, noise in others. - Heading and block links survive file renames but not heading renames done outside Obsidian. - The [[Note composer core plugin for Obsidian]] can extract a selection into a new note and leave a wikilink behind. ## References - Internal links: https://help.obsidian.md/Linking+notes+and+files/Internal+links ## Related - [[Obsidian]] - [[Obsidian Embeds]] - [[Obsidian Aliases]] - [[Obsidian Unlinked Mentions]] - [[Block references]] - [[Obsidian Flavored Markdown]] - [[Obsidian Graph view]] - [[Backlinks core plugin for Obsidian]] - [[Note composer core plugin for Obsidian]]