obsidian-markdown

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

3|1|Updated Oct 8, 2025
One-click install
npx skills add https://github.com/maedmatt/dotfiles --skill obsidian-markdown-maedmatt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/maedmatt/dotfiles/tree/main/shared/skills/obsidian-markdown
Command: npx skills add https://github.com/maedmatt/dotfiles --skill obsidian-markdown-maedmatt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables agents to create, edit, and validate Obsidian Flavored Markdown notes, ensuring compatibility with Obsidian features like wikilinks, embeds, callouts, frontmatter, and tags.

Core Features & Use Cases

  • Wikilinks and Embeds: Generate and resolve [[Note]] links and ![[image.png]] embeds.
  • Frontmatter and Tags: Add YAML frontmatter with title, date, tags, aliases, and CSS classes.
  • Callouts and Obsidian Syntax: Create Obsidian-style callouts and maintain syntax extensions for notes.
  • Use Case: Maintain a knowledge vault by creating interconnected notes with consistent metadata and cross-references.

Quick Start

Generate an Obsidian-compatible Markdown note containing a wikilink [[Project Plan]], an embed ![[Diagram.png]], and a frontmatter block:

  • topic: "Project Plan"
  • tags: ["project", "planning"]

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I generate Obsidian markdown with wikilinks and frontmatter?

To generate Obsidian markdown, you create notes with [[wikilinks]] and YAML frontmatter containing tags and aliases. This ensures notes render correctly with proper metadata and cross-references in your vault.

What is the correct syntax for embedding images in Obsidian notes?

The correct syntax for embedding images in Obsidian notes uses the ![[image.png]] format. This embeds media directly into your note, allowing visual content to render natively within your Obsidian vault.

How do I add YAML frontmatter and tags to an Obsidian note?

To add YAML frontmatter, insert a block at the top of your note defining title, date, tags, and aliases. This structures note metadata so Obsidian can properly parse properties and manage tags across your vault.

Can I use Obsidian callouts to format notes with native syntax extensions?

Yes, you can use Obsidian-style callouts to format notes with native syntax extensions. Callouts allow you to create formatted warning or info blocks that render correctly using Obsidian Flavored Markdown.

What is the best way to maintain interconnected notes in a knowledge vault?

The best way to maintain interconnected notes is generating notes with consistent wikilinks and frontmatter. This creates reliable cross-references and standardized metadata, keeping your Obsidian vault organized and navigable.

Does standard markdown support Obsidian wikilinks and embeds?

Standard markdown does not natively support Obsidian wikilinks and embeds. You need Obsidian Flavored Markdown syntax like [[Note]] links and ![[media.png]] embeds to ensure notes render correctly in an Obsidian vault.