Obsidian Flavored Markdown Skill
This skill enables Claude Code to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions.
Overview
Obsidian uses a combination of Markdown flavors:
- CommonMark
- GitHub Flavored Markdown
- LaTeX for math
- Obsidian-specific extensions (wikilinks, callouts, embeds, etc.)
Basic Formatting
Paragraphs and Line Breaks
Headings
Text Formatting
Escaping Formatting
Use backslash to escape special characters:
Common characters to escape: \*, \_, \#, \`, \|, \~
Internal Links (Wikilinks)
Basic Links
Link to Headings
Link to Blocks
Define a block ID by adding ^block-id at the end of a paragraph:
For lists and quotes, add the block ID on a separate line:
Search Links
Markdown-Style Links
Note: Spaces must be URL-encoded as %20 in Markdown links.
Embeds
Embed Notes
Embed Images
External Images
Embed Audio
Embed PDF
Embed Lists
Where the list has been defined with a block ID:
Embed Search Results
Callouts
Basic Callout
Foldable Callouts
Nested Callouts
Supported Callout Types
Custom Callouts (CSS)
Lists
Unordered Lists
Ordered Lists
Task Lists
Quotes
Code
Inline Code
Code Blocks
Nesting Code Blocks
Use more backticks or tildes for the outer block:
Tables
Alignment
Using Pipes in Tables
Escape pipes with backslash:
Math (LaTeX)
Inline Math
Block Math
Common Math Syntax
Diagrams (Mermaid)
Sequence Diagrams
Linking in Diagrams
Footnotes
Comments
Horizontal Rules
Properties (Frontmatter)
Properties use YAML frontmatter at the start of a note:
Property Types
Default Properties
tags- Note tagsaliases- Alternative names for the notecssclasses- CSS classes applied to the note
Tags
Tags can contain:
- Letters (any language)
- Numbers (not as first character)
- Underscores
_ - Hyphens
- - Forward slashes
/(for nesting)
HTML Content
Obsidian supports HTML within Markdown:


