Write correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax. Reference this when creating or editing any wiki page. Triggers on: write obsidian note, obsidian syntax, wikilink, callout, embed, obsidian markdown, wikilink format, callout syntax, embed syntax, obsidian formatting, how to write obsidian markdown.
Reference this skill when writing any wiki page. Obsidian extends standard Markdown with wikilinks, embeds, callouts, and properties. Getting syntax wrong causes broken links, invisible callouts, or malformed frontmatter.
Cross-reference: If the kepano/obsidian-skills plugin is installed, prefer its canonical obsidian-markdown skill for authoritative Obsidian syntax reference. Otherwise, use the reference below. See also github.com/kepano/obsidian-skills.
Internal links use double brackets. The filename without extension.
| Syntax | What it does |
|---|---|
[[Note Name]] | Basic link |
[[Note Name|Display Text]] | Aliased link (shows "Display Text") |
[[Note Name#Heading]] | Link to a specific heading |
[[Note Name#^block-id]] | Link to a specific block |
Rules:
[[Folder/Note Name]] to disambiguate.Embeds use ! before the wikilink. They display the content inline.
| Syntax | What it does |
|---|---|
![[Note Name]] | Embed a full note |
![[Note Name#Heading]] | Embed a section |
![[image.png]] | Embed an image |
![[image.png|300]] | Embed image with width 300px |
![[document.pdf]] | Embed a PDF (Obsidian renders natively) |
![[audio.mp3]] | Embed audio |
Callouts are blockquotes with a type keyword. They render as styled alert boxes.
> [!note]
> Default informational callout.
> [!note] Custom Title
> Callout with a custom title.
> [!note]- Collapsible (closed by default)
> Click to expand.
> [!note]+ Collapsible (open by default)
> Click to collapse.
| Type | Aliases | Use for |
|---|---|---|
note | : | General notes |
abstract | summary, tldr | Summaries |
info | : | Information |
todo | : | Action items |
tip | hint, important | Tips and highlights |
success | check, done | Positive outcomes |
question | help, faq | Open questions |
warning | caution, attention | Warnings |
failure | fail, missing | Errors or failures |
danger | error | Critical issues |
bug | : | Known bugs |
example | : | Examples |
quote | cite | Quotations |
contradiction | : | Conflicting information (wiki convention) |
Obsidian renders YAML frontmatter as a Properties panel. Rules:
---