obsidian-markdown

Format Obsidian-flavored Markdown notes with frontmatter, wikilinks, and embeds.

13|1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/debug-zhuweijian/ai-research-toolkit --skill obsidian-markdown-debug-zhuweijian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/debug-zhuweijian/ai-research-toolkit/tree/main/modules/05-knowledge/skills/obsidian-markdown
Command: npx skills add https://github.com/debug-zhuweijian/ai-research-toolkit --skill obsidian-markdown-debug-zhuweijian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian Markdown formatting has specific extensions (wikilinks, embeds, callouts, properties) that are not covered by standard Markdown. This skill provides a structured approach to creating and editing Obsidian-flavored Markdown notes with correct frontmatter and syntax.

Core Features & Use Cases

  • Frontmatter-driven metadata: add title, tags, aliases, and other properties at the top for reliable search and linking.
  • Obsidian extensions: use wikilinks, embeds, callouts, and properties to organize vault content.
  • Real-world use: author new notes for research projects, maintain knowledge graphs, or refactor existing notes to Obsidian standards.

Quick Start

Create a new Obsidian note, add frontmatter with title and tags, and write content using wikilinks and embeds.

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

Formatting Obsidian markdown notes requires adding frontmatter at the top for title and tags, then structuring content with wikilinks and embeds. This validates rendering in Obsidian's reading view and ensures reliable vault search.

What is the difference between standard Markdown and Obsidian-flavored Markdown?

Obsidian-flavored Markdown differs from standard Markdown by adding wikilinks, embeds, callouts, and frontmatter properties. These extensions enable interlinked notes and structured metadata within an Obsidian vault.

How do I add frontmatter properties to Obsidian notes for better search?

Adding frontmatter properties involves placing structured YAML metadata at the top of Obsidian notes. Defining title, tags, and aliases in this block ensures reliable search and linking across the vault.

Can I use standard Markdown formatting tools for Obsidian vault maintenance?

Standard Markdown tools lack support for Obsidian extensions like wikilinks, embeds, and callouts. Refactoring notes to Obsidian standards requires an approach that specifically validates Obsidian syntax conventions.

Why does my Obsidian note rendering break in reading view?

Rendering breaks in Obsidian's reading view when frontmatter structure is incorrect or wikilinks and embeds use invalid syntax. Validating notes against Obsidian syntax conventions ensures proper rendering.