obsidian-markdown

Generate Obsidian-flavored Markdown with wikilinks, embeds, callouts, and YAML frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian-markdown helps agents create and edit Obsidian-flavored Markdown reliably, addressing the challenge of applying Obsidian-specific syntax consistently across notes.

Core Features & Use Cases

  • Supports wikilinks, embeds, callouts, and YAML frontmatter for complete Obsidian notes.
  • Generates correctly structured Markdown with Obsidian-specific syntax (tags, properties, and embeds) suitable for vault-wide consumption.
  • Use Case: Draft a note that references other notes with [[Note]], includes embeds like ![[Note#Heading]] and uses frontmatter for metadata.

Quick Start

Create a new Obsidian note that uses wikilinks, embeds, and a YAML frontmatter header, for example:

title: Example Note date: 2024-02-01 tags:

  • example

Then add content that uses [[Another Note]] and ![[Image.png]] as appropriate.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I create Obsidian notes with wikilinks and embeds?

Wikilinks reference other notes using [[Note Name]] syntax, while embeds include content via ![[Note#Heading]] or ![[Image.png]]. Both are Obsidian-specific Markdown features that link and nest content across your vault reliably.

What is YAML frontmatter and why do I need it in Obsidian?

YAML frontmatter is metadata at the top of a note enclosed in --- delimiters, containing properties like title, date, and tags. Obsidian uses it to organize and query notes consistently across your vault.

Can I use callouts in Obsidian Markdown?

Yes, callouts are Obsidian-specific syntax blocks that highlight important information. They render as styled boxes and are fully supported alongside wikilinks, embeds, and frontmatter in your notes.

How do I structure a complete Obsidian note with all syntax elements?

Start with YAML frontmatter (title, date, tags), then write body content using wikilinks for [[references]], embeds for ![[media]], and callouts for highlighted sections. This generates correctly formatted notes ready for vault-wide use.

Do I need to learn Obsidian-specific syntax to organize my notes?

Yes, Obsidian-specific syntax—wikilinks, embeds, callouts, and frontmatter—enables reliable cross-note references and metadata management. Learning these elements ensures your notes integrate properly across the vault.