skills.rest
kouko
koukoCOMMUNITY
Explore all skills by this author →
GitHub

obsidian-markdown

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

6|1|Updated Apr 2, 2026
Search Tags:#markdown#mermaid#obsidian#frontmatter#wikilinks#callouts#embeds
One-click install
npx skills add https://github.com/kouko/monkey-skills --skill obsidian-markdown-kouko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/kouko/monkey-skills/tree/main/obsidian/skills/obsidian-markdown
Command: npx skills add https://github.com/kouko/monkey-skills --skill obsidian-markdown-kouko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many writers and knowledge workers need Obsidian-specific Markdown to render correctly in a vault, but standard Markdown editors and automated conversions often miss wikilinks, embeds, callouts, frontmatter properties, block IDs, math, and mermaid diagrams; this skill removes that ambiguity and ensures notes follow Obsidian conventions.

Core Features & Use Cases

  • Frontmatter & Properties: Guidance for constructing YAML frontmatter with title, date, tags, aliases, cssclasses, and status so notes are discoverable and searchable in the vault.
  • Internal Links, Embeds & Block IDs: Correct formatting for wikilinks, same-note headings, block ID anchors, and embedded files or sections so references and embeds render reliably.
  • Callouts, Math & Diagrams: Support for Obsidian callout syntax, LaTeX math blocks, and Mermaid diagrams with notes on hooking nodes to internal links and rendering considerations.
  • Use Case: Migrate a plain Markdown project brief into an Obsidian note with proper frontmatter, a Table of Contents, internal wikilinks to meeting notes, an embedded architecture diagram, and callouts for important decisions.

Quick Start

Create a new Obsidian note titled Project Alpha with YAML frontmatter including title, date, tags, and status, add a Table of Contents after the top heading, insert wikilinks to related notes, embed Architecture Diagram.png at 600 width, and add a callout highlighting the key deadline.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I format Obsidian wikilinks and embeds correctly in Markdown?▼

Obsidian wikilinks use [[double brackets]] while embeds use ![[double brackets]] to reference files or sections. This syntax ensures internal links and embedded media render reliably within the Obsidian vault reading view.

What is the correct syntax for Obsidian callouts and frontmatter properties?▼

Obsidian callouts use blockquote syntax prefixed with [!type], while frontmatter properties require valid YAML formatted with title, tags, aliases, and status. This structure makes notes discoverable and searchable in the vault.

Can I add Mermaid diagrams and LaTeX math blocks to Obsidian Markdown?▼

Yes, Obsidian supports Mermaid diagrams and LaTeX math blocks within Markdown notes. You can hook Mermaid nodes to internal wikilinks and format math blocks to ensure rendering compatibility with Obsidian reading view.

What's the best way to migrate plain Markdown into an Obsidian vault?▼

Converting plain Markdown into Obsidian notes involves adding YAML frontmatter, inserting wikilinks to related notes, embedding media files, and applying callouts for key decisions. This process ensures proper internal linking and vault structure.

Does Obsidian Markdown support block ID anchors for same-note headings?▼

Yes, Obsidian Markdown supports block ID anchors and same-note heading references. Using correct block ID formatting ensures references and embeds render reliably when navigating between sections within an Obsidian vault.

Related Skills

Explore More Content & Communication Skills→
dr-codedr-code

obsidian-markdown

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

Community
Intermediate
DavidsonGomesDavidsonGomes

obs-obsidian-markdown

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

Community
Intermediate
yopitekyopitek

obsidian-markdown

Author and edit Obsidian-flavored Markdown with wikilinks, embeds, callouts, and frontmatter.

Community
Intermediate
7loro7loro
1

obsidian-markdown

Create and edit Obsidian-flavored Markdown notes with wikilinks, embeds, callouts, and frontmatter.

Community
Basic