obsidian-markdown

Purpose

This skill teaches agents the complete Obsidian Flavored Markdown specification — the set of syntax extensions that Obsidian adds on top of standard CommonMark and GitHub Flavored Markdown. These extensions are not valid in plain Markdown editors and must be written correctly to work in Obsidian.

Standard Markdown knowledge is assumed. This skill covers only the Obsidian-specific additions: wikilinks, embeds, callouts, properties (frontmatter), block IDs, comments, and Obsidian-specific formatting. Agents that generate Markdown without this skill will produce notes that look correct in a plain editor but break Obsidian's linking, embedding, and graph features.

This skill is the foundation of all Obsidian-related work in this repository. Other skills such as obsidian-links, obsidian-frontmatter, and obsidian-note-builder build on top of the syntax defined here.

When to Use

Invoke this skill when:

• The user asks to create a new note in Obsidian
• The user wants to add links between notes using the [[wikilink]] format
• The user needs to embed content from another note, image, or PDF
• The user wants to add callouts (highlighted info blocks) to a note
• The user needs to set frontmatter properties (tags, aliases, cssclasses, custom fields)
• The user wants to link to a specific heading or block within a note
• The user asks to create a note that "links to" or "is linked from" another note