obsidian-markdown

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

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/dr-code/beacon --skill obsidian-markdown-dr-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/dr-code/beacon/tree/main/plugins/all-skills/skills/obsidian-markdown
Command: npx skills add https://github.com/dr-code/beacon --skill obsidian-markdown-dr-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the uncertainty and manual work of producing Obsidian-compatible Markdown by providing clear, consistent syntax for wikilinks, embeds, callouts, frontmatter, tags, and block references so notes work correctly inside an Obsidian vault.

Core Features & Use Cases

  • Wikilinks and Block References: Generate internal links, heading links, and block reference syntax including block IDs for easy cross-referencing.
  • Embeds and Media: Create note, image, audio, video, and PDF embeds with sizing and page options for rich documents.
  • Callouts, Frontmatter & Tags: Format callouts (foldable and nested), YAML frontmatter with multi-value properties, and inline or nested tags for organization.
  • Diagrams, Math, and Code: Include mermaid diagrams, LaTeX math blocks, fenced code with language hints, and footnotes to support technical documentation and notes.
  • Use Case Example: Convert raw meeting notes into a polished Obsidian note with YAML metadata, task checklists, wikilinks to related projects, embedded diagrams, and block IDs for future referencing.

Quick Start

Convert this plain meeting transcript into Obsidian Flavored Markdown including YAML frontmatter with tags, wikilinks for referenced projects, an embedded diagram placeholder, callouts for action items, and block IDs for key paragraphs.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I convert plain text notes into Obsidian Flavored Markdown with wikilinks and frontmatter?

To convert plain text into Obsidian Flavored Markdown, apply YAML frontmatter for metadata, use double-bracket wikilinks for internal cross-referencing, and add block reference syntax. This ensures notes function correctly within an Obsidian vault.

Can I create foldable callouts and nested tags for Obsidian notes?

Yes, you can format foldable and nested callouts alongside inline or nested tags for organization. Callouts support nesting to structure complex information, while nested tags enable hierarchical categorization within the vault.

How do block references and embeds work in Obsidian Markdown?

Block references use block IDs for easy cross-referencing of specific paragraphs, while embeds allow you to insert notes, images, audio, video, and PDFs directly into documents with sizing and page options for rich content.

Does Obsidian Markdown support mermaid diagrams and LaTeX math blocks?

Yes, Obsidian Markdown supports mermaid diagrams, LaTeX math blocks, and fenced code with language hints. These constructs integrate seamlessly with standard Markdown for technical documentation and advanced note-taking.

What is the best way to structure YAML frontmatter with multi-value properties in Obsidian?

The best way to structure YAML frontmatter is preserving its native syntax while defining multi-value properties. This maintains metadata integrity and ensures Obsidian correctly parses tags, aliases, and other custom fields.

Why are my standard Markdown files not displaying correctly inside an Obsidian vault?

Standard Markdown files may not display correctly because Obsidian requires specific syntax like wikilinks, block references, and callouts. Converting plain text to Obsidian Flavored Markdown resolves compatibility issues and unlocks native vault features.