obsidian-markdown

Provides authoritative Obsidian Flavored Markdown syntax rules for writing vault notes.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill obsidian-markdown-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-knowledge/skills/obsidian-markdown
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill obsidian-markdown-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing notes for Obsidian vaults requires precise Obsidian Flavored Markdown syntax — wikilinks, embeds, callouts, and frontmatter properties — and small mistakes like unresolved wikilinks or deprecated singular tag: properties silently degrade graph quality and rendering. ## Core Features & Use Cases - OFM Syntax Reference: Authoritative rules for wikilinks, block IDs, embeds, tags, callouts, highlights, comments, LaTeX, and Mermaid diagrams. - Frontmatter Property Guidance: Correct property types (Text, Number, Checkbox, Date, List, Links) with plural tags/aliases forms required since Obsidian 1.9. - Grep-able Reference Files: Detailed lookup tables for callout aliases, embed variants, and property types in references/ for targeted queries. - Use Case: Ask the AI to draft a vault note with a wikilink to another note, a foldable warning callout, and frontmatter with tags and aliases — the output uses valid OFM that renders correctly in Obsidian. ## Quick Start Write an Obsidian note about project kickoff that links to my Team Roster note, includes a warning callout, and sets tags and aliases in the frontmatter.

Frequently Asked Questions about obsidian-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write wikilinks in Obsidian markdown?

Wikilinks use double brackets like [[Note]] to link internal vault notes, with variants [[Note|Display text]] for custom labels and [[Note#Heading]] for heading links. Use standard Markdown links only for external URLs, and verify each wikilink resolves to a real note.

How do I add callouts in Obsidian notes?

Callouts use blockquote syntax: > [!type] Title followed by indented content lines. Supported types include note, tip, warning, and danger, with foldable variants using > [!type]- for collapsed or > [!type]+ for expanded by default.

What frontmatter properties does Obsidian support?

Obsidian 1.9+ supports built-in plural properties tags, aliases, and cssclasses, plus typed properties: Text, Number, Checkbox, Date, Date & Time, List, and Links. Singular forms like tag: and alias: are deprecated; use YAML list syntax instead.

Can I embed PDF pages or images in Obsidian notes?

Yes, embeds use ![[file]] syntax: ![[image.png|200]] sets image width, and ![[file.pdf#page=3]] embeds a specific PDF page. Audio, video, note blocks, and search query embeds are also supported.

When should I not use Obsidian Flavored Markdown?

Avoid OFM for standard Markdown outside Obsidian, where CommonMark or GFM applies instead. Dataview queries and Templater or Meta Bind DSLs are separate plugin languages, not part of core OFM syntax.