obsidian-markdown

Convert and validate Obsidian Flavored Markdown notes with frontmatter, wikilinks, embeds, callouts, tags, and block IDs.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Nero-kk/claude-agent-skills --skill obsidian-markdown-nero-kk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/Nero-kk/claude-agent-skills/tree/main/claude-skills/obsidian-markdown
Command: npx skills add https://github.com/Nero-kk/claude-agent-skills --skill obsidian-markdown-nero-kk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian-flavored Markdown introduces vault-specific syntax that authors frequently get wrong or forget, such as frontmatter properties, wikilinks, embeds, block IDs, callouts, tags, and formatting for diagrams and math. This skill reduces formatting errors, speeds note creation, and ensures notes render and link correctly inside an Obsidian vault.

Core Features & Use Cases

  • Frontmatter guidance: Compose and validate YAML frontmatter with title, tags, aliases, dates, and custom properties for consistent metadata.
  • Wikilinks and embeds: Produce correct internal links, heading and block references, and file embeds for images, PDFs, audio, and sections.
  • Callouts, tags, and formatting: Create callouts, nested callouts, highlight syntax, math blocks, mermaid diagrams, and proper tag syntax for vault organization.
  • Use Case: Prepare a project note with consistent frontmatter, backlink-friendly wikilinks, embedded architecture diagrams, and callouts for decisions so the note integrates cleanly into the vault graph.

Quick Start

Open or create a note and convert or format its content into valid Obsidian Flavored Markdown with frontmatter, wikilinks, embeds, callouts, and proper tag syntax.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I convert standard markdown into Obsidian wikilinks and frontmatter?

To convert standard markdown into Obsidian flavored markdown, you format the content with proper YAML frontmatter, wikilinks, embeds, callouts, tags, and block IDs. This ensures notes render and link correctly inside an Obsidian vault.

What is the correct syntax for Obsidian callouts and nested tags?

Obsidian callouts and nested tags require specific formatting syntax to render correctly in the reading view. You construct proper callout blocks, nested callouts, highlight syntax, and nested tag structures to ensure stable rendering and vault organization.

Can I validate YAML frontmatter properties for my Obsidian notes?

Yes, you can validate YAML frontmatter properties for Obsidian notes. The process composes and validates YAML frontmatter containing title, tags, aliases, dates, and custom properties to ensure consistent metadata across your vault.

How do I embed images and sections in Obsidian markdown?

To embed images and sections in Obsidian markdown, you produce correct internal links, heading and block references, and file embeds. This includes formatting embeds for images, PDFs, audio, and sections for backlinking workflows.

Does Obsidian markdown support mermaid diagrams and LaTeX math blocks?

Obsidian markdown supports mermaid diagrams and LaTeX math blocks through specific formatting syntax. You format math blocks and mermaid diagrams correctly to ensure compatibility and stable rendering within Obsidian's reading view.

What is the best way to migrate external markdown into an Obsidian vault?

The best way to migrate external markdown into an Obsidian vault is to convert and validate the content into Obsidian flavored markdown. This applies proper frontmatter, wikilinks, embeds, and callouts so notes integrate cleanly into the vault graph.