obsidian-markdown

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

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Blake-John/agent-config --skill obsidian-markdown-blake-john
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/Blake-John/agent-config/tree/main/.zeroclaw/workspace/skills/obsidian-markdown
Command: npx skills add https://github.com/Blake-John/agent-config --skill obsidian-markdown-blake-john

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian-specific Markdown requires correct handling of wikilinks, embeds, callouts, frontmatter, and properties to keep vaults navigable and consistent; this skill guides users to create valid Obsidian-flavored Markdown and avoid syntax pitfalls.

Core Features & Use Cases

  • Wikilinks: create internal connections with [[Note]] and manage display text and heading anchors.
  • Embeds and callouts: embed content with ![[Note]] and add rich callouts to highlight important information.
  • Frontmatter and properties: apply YAML frontmatter with title, tags, and aliases to enable tagging, linking, and metadata.

Quick Start

Create a sample Obsidian note by adding frontmatter with title and tags, then 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 create Obsidian markdown notes with proper wikilinks and frontmatter?

Obsidian markdown notes use YAML frontmatter for properties like title and tags, and [[Note]] syntax for wikilinks to connect internal files. This ensures your vault remains navigable and consistently structured.

What is the correct syntax for embedding content and callouts in Obsidian?

Embedding content in Obsidian uses the ![[Note]] syntax to pull external files directly into your text. Callouts are added to highlight important information, ensuring Obsidian syntax is respected.

How do I manage display text and heading anchors in Obsidian wikilinks?

Managing display text and heading anchors in Obsidian wikilinks involves modifying the [[Note]] syntax to specify exact sections. This keeps internal linking precise and avoids syntax pitfalls during vault workflows.

Why does my Obsidian markdown formatting break when I add properties?

Obsidian markdown formatting breaks when properties are added incorrectly due to invalid YAML frontmatter syntax. Applying frontmatter with proper title, tags, and aliases ensures metadata is recognized for tagging and linking.

Does this approach work for organizing large Obsidian vaults with many internal links?

Yes, this approach works for organizing large Obsidian vaults by applying consistent wikilinks, embeds, and frontmatter properties. It guides you to create valid Obsidian-flavored markdown and avoid syntax pitfalls across workflows.