obsidian-markdown

Generate and edit Obsidian Flavored Markdown with wikilinks, callouts, embeds, and YAML frontmatter.

Updated May 26, 2026
One-click install
npx skills add https://github.com/Peiwvy/myskills --skill obsidian-markdown-peiwvy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/Peiwvy/myskills/tree/main/obsidian-markdown
Command: npx skills add https://github.com/Peiwvy/myskills --skill obsidian-markdown-peiwvy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of creating Markdown that works correctly inside Obsidian, including its unique syntax for links, callouts, embeds, properties, and other vault-specific features.

Core Features & Use Cases

  • Obsidian Flavored Markdown authoring: Produces CommonMark/GFM-compatible Markdown while also supporting Obsidian extensions like wikilinks, callouts, embeds, and block links.
  • Structured note content: Helps generate correct syntax for frontmatter properties, tags, headings, lists (including task lists), tables, footnotes, and diagrams (Mermaid).
  • Rich content inclusion: Supports embeds for notes, media (images/audio/PDF), block- and list-level references, and search-style query blocks.

Quick Start

Use the obsidian-markdown skill to write an Obsidian note that includes wikilinks, a callout, frontmatter properties, and an embedded image for your project page.

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 flavored Markdown with wikilinks and callouts?

To write Obsidian flavored Markdown, generate CommonMark-compatible text and apply vault-specific extensions like wikilinks, callouts, block references, and embeds. This ensures notes interlink correctly and display properly inside the Obsidian knowledge base.

What is the correct syntax for YAML frontmatter properties in Obsidian?

YAML frontmatter properties in Obsidian require correct property conventions placed at the top of a note. Generating structured frontmatter ensures tags, headings, lists, and metadata are parsed correctly by the vault system.

How do I embed files and query results inside an Obsidian note?

Embedding files and query results inside an Obsidian note uses specific embed syntax for media, block-level references, and search-style query blocks. Applying correct embed formatting ensures media and referenced content render natively.

Can I use Mermaid diagrams and math formatting in Obsidian Markdown?

Yes, Obsidian Markdown supports Mermaid diagrams and math formatting within structured note content. Generating the correct syntax for these diagrams ensures they render visually inside the Obsidian application.

Does Obsidian Markdown support URL-encoding for heading and block references?

Obsidian Markdown requires proper URL-encoding in Markdown links for heading and block references. Applying correct URL-encoding formats ensures links resolve accurately to specific text selections or blocks.