obsidian-markdown

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian-flavored Markdown editing can be error-prone and time-consuming when applying Obsidian-specific features like wikilinks, embeds, callouts, and frontmatter. This guide helps agents generate, edit, and validate notes that remain fully compatible with Obsidian vaults.

Core Features & Use Cases

  • Obsidian syntax support including wikilinks, embeds, callouts, and block references.
  • Validation and formatting to ensure notes render correctly in Obsidian and integrate with metadata.
  • Real-world use: craft vault documentation, personal knowledge bases, and project notes that rely on Obsidian features.

Quick Start

Create a new Obsidian note using Obsidian syntax and verify wikilinks render properly.

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 wikilinks and embeds?

To create Obsidian markdown notes with wikilinks and embeds, you apply Obsidian-flavored syntax extensions like wikilinks, block references, and embeds, then validate the formatting to ensure the notes render correctly in your Obsidian vault.

What is YAML frontmatter and how does it work in Obsidian?

YAML frontmatter in Obsidian is metadata placed at the top of a note using name and description fields. It integrates with your vault's data structure, allowing agents to generate and validate notes that remain fully compatible with Obsidian's metadata features.

Can I use callouts and block references when editing Obsidian markdown?

Yes, you can use callouts and block references when editing Obsidian markdown. The syntax supports these specific extensions, allowing you to craft personal knowledge bases and project notes that rely on Obsidian's native rendering features.

What's the best way to validate Obsidian syntax for vault maintenance?

The best way to validate Obsidian syntax for vault maintenance is to apply formatting checks that confirm wikilinks, frontmatter, and embeds render properly. This ensures notes integrate with metadata and display correctly within Obsidian.

Why does my Obsidian markdown not render wikilinks properly?

Obsidian markdown may not render wikilinks properly if the syntax is incorrect or unsupported. Validating the note's formatting and ensuring it conforms to Obsidian syntax extensions for wikilinks and embeds resolves these rendering errors.

Do I need any dependencies to generate Obsidian-flavored markdown?

No dependencies are required to generate Obsidian-flavored markdown. The guide provides a ready-to-run Quick Start that enables agents to directly create and edit notes using Obsidian syntax, frontmatter, and embeds without external setup.