obsidian-markdown

SKILL.md

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, and properties.

Covers Obsidian-specific syntax extensions: wikilinks ([[Note]]), embeds (![[Note]]), callouts (> [!type]), block IDs, and frontmatter properties

Supports internal vault linking with automatic rename tracking, plus embeds for notes, images, PDFs, and external media

Includes callout types (note, warning, tip, danger, etc.), inline and block comments, highlights, LaTeX math, and Mermaid diagrams

Assumes standard Markdown knowledge (headings, lists, tables, code blocks); focuses only on Obsidian extensions

Obsidian Flavored Markdown Skill

Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.

Workflow: Creating an Obsidian Note

Add frontmatter with properties (title, tags, aliases) at the top of the file. See PROPERTIES.md for all property types.

Write content using standard Markdown for structure, plus Obsidian-specific syntax below.

Link related notes using wikilinks ([[Note]]) for internal vault connections, or standard Markdown links for external URLs.

Embed content from other notes, images, or PDFs using the ![[embed]] syntax. See EMBEDS.md for all embed types.

Add callouts for highlighted information using > [!type] syntax. See CALLOUTS.md for all callout types.

Verify the note renders correctly in Obsidian's reading view.

When choosing between wikilinks and Markdown links: use [[wikilinks]] for notes within the vault (Obsidian tracks renames automatically) and [text](url) for external URLs only.

Internal Links (Wikilinks)