Obsidian Markdown

Creates proper Obsidian-flavored markdown with all the vault-specific syntax that standard markdown parsers don't handle. Handles wikilinks with custom display text and section references, embeds for notes and media, the full callout system with folding, YAML frontmatter properties, and block references. Most useful when you're building notes that need to link together or when you want callouts and embeds to render correctly in Obsidian. The workflow approach is solid, walking through frontmatter setup to content creation to verification. Covers the syntax differences that trip people up when moving from regular markdown to Obsidian's extended version.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 6
skills.sh installs: 95.7K
GitHub stars: 51.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

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.