obsidian-markdown

Create Obsidian Flavored Markdown with wikilinks, embeds, callouts, and frontmatter.

17|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ivanrvpereira/.agents --skill obsidian-markdown-ivanrvpereira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/ivanrvpereira/.agents/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/ivanrvpereira/.agents --skill obsidian-markdown-ivanrvpereira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the friction of writing correct Obsidian Flavored Markdown by guiding you through Obsidian-specific syntax that standard Markdown doesn’t cover.

Core Features & Use Cases

  • Wikilinks and link targets: Supports [[Note]], heading links, and block IDs for reliable vault navigation.
  • Embeds and rich content: Covers ![[...]] embeds for notes, images, and PDFs (including page/height variations).
  • Callouts, properties, and tags: Provides the syntax for > [!type] callouts plus YAML frontmatter properties like title, tags, aliases, and cssclasses, and inline #tags.
  • Obsidian additions: Includes highlights (==...==), comments, math (LaTeX), Mermaid diagrams, and footnotes in Obsidian formats.

Quick Start

Tell the AI you want to create an Obsidian note that includes YAML frontmatter, wikilinks between related notes, a callout section, and at least one embedded image or PDF.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I write Obsidian markdown for wikilinks and embedded notes?

Obsidian markdown for wikilinks and embeds uses specific syntax like [[Note]] for links and ![[...]] for embedding notes, images, and PDFs. This approach ensures reliable vault navigation and rich content integration beyond standard Markdown.

What is the correct syntax for Obsidian callouts and YAML frontmatter?

Obsidian callouts use the > [!type] syntax, while YAML frontmatter organizes metadata properties like title, tags, aliases, and cssclasses. These features structure notes and highlight important information within your vault.

Does standard Markdown support Obsidian features like math, Mermaid diagrams, and footnotes?

Standard Markdown does not support Obsidian-specific additions like LaTeX math, Mermaid diagrams, footnotes, and ==highlights==. Obsidian Flavored Markdown extends CommonMark and GFM to implement these specific formatting and diagramming rules.

How do I link to a specific heading or block ID in an Obsidian note?

Linking to specific headings or block IDs in Obsidian uses extended wikilink syntax. This allows precise navigation within a vault by targeting individual sections or data blocks rather than just the entire note.

What are the limitations of using CommonMark or GFM for Obsidian notes?

CommonMark and GFM cannot process Obsidian vault-specific syntax, meaning wikilinks, embeds, callouts, and YAML frontmatter properties will not render correctly. You need Obsidian Flavored Markdown to implement tags, comments, and knowledge linking workflows.