obsidian-markdown

Generate Obsidian Markdown with wikilinks, embeds, callouts, and frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian users and teams often struggle to consistently craft and edit notes in Obsidian-flavored Markdown that use wikilinks, embeds, callouts, and frontmatter. This skill provides a canonical way to generate and validate Markdown that adheres to Obsidian's syntax, reducing formatting errors and increasing note quality.

Core Features & Use Cases

  • Supports wikilinks, such as [[Note]] and [[Note|Display Text]] with correct escaping.
  • Handles embeds like ![[Note]] and embedded media or images.
  • Creates and validates Obsidian callouts, code blocks, tables, and LaTeX blocks in the Obsidian flavor.
  • Preserves and applies frontmatter properties for tags, dates, and metadata to support organization and search.
  • Use cases include drafting new notes from outlines, converting outlines to Obsidian-ready documents, and validating existing notes for syntax conformance.

Quick Start

Create or update a document in Obsidian-flavored Markdown that includes wikilinks, embeds, callouts, and a YAML frontmatter section.

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 markdown notes with correct wikilinks and callouts?

To create Obsidian markdown notes, draft your content using specific syntax like [[Note]] for wikilinks and blockquotes for callouts. This process validates and generates text that adheres to Obsidian's unique formatting standards, reducing syntax errors.

What is the correct syntax for embedding files and media in Obsidian markdown?

Embedding files in Obsidian markdown requires using the exclamation mark prefix before a wikilink, such as ![[Note]]. This embeds media or entire notes directly into your document, maintaining proper Obsidian-flavored structure for images and blocks.

How do I add frontmatter properties and metadata to Obsidian notes?

Adding frontmatter properties to Obsidian notes involves inserting a YAML block at the document's start to define tags, dates, and metadata. This preserves organization and searchability across your personal knowledge base and project docs.

Does Obsidian markdown support LaTeX math blocks and tables?

Obsidian markdown fully supports LaTeX math blocks, standard tables, and code blocks within notes. This ensures complex mathematical formulas and structured data render correctly in the Obsidian flavor without formatting issues.

What is the best way to validate existing Obsidian notes for syntax conformance?

Validating existing Obsidian notes involves checking documents for correct wikilink escaping, callout formatting, and frontmatter structure. This ensures your research notes conform to Obsidian syntax, preventing broken embeds and formatting errors.

Can I convert an outline into an Obsidian-ready document with wikilinks?

Converting an outline into an Obsidian-ready document uses generated markdown that applies wikilinks, embeds, and frontmatter. This transforms raw outlines into structured personal knowledge base notes with correct Obsidian syntax.