obsidian-markdown

Validate Obsidian-specific markdown syntax against vault structure.

149|8|Updated Jun 17, 2022
One-click install
npx skills add https://github.com/edonyzpc/personal-assistant --skill obsidian-markdown-edonyzpc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/edonyzpc/personal-assistant/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/edonyzpc/personal-assistant --skill obsidian-markdown-edonyzpc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users frequently encounter errors when using Obsidian's custom markdown features that differ from standard CommonMark, leading to broken links, malformed callouts, and incorrectly formatted properties in their notes. This Skill eliminates that guesswork by providing precise, context-aware syntax guidance tailored specifically to Obsidian's unique functionality.

Core Features & Use Cases

  • Obsidian-Specific Syntax Reference: Covers all custom Obsidian markdown features including wikilinks (with aliases, heading anchors, and block references), embeds, callouts (including nested variants), YAML frontmatter properties, and nested tag formatting.
  • Vault-Context Aware Validation: Uses built-in vault inspection tools to verify note-specific syntax rules before providing recommendations, ensuring advice matches your actual vault structure rather than generic CommonMark defaults.
  • Use Case: If you need to link to a specific block in another note or create a nested callout for a research project, this Skill gives you the exact, working syntax for your vault.

Quick Start

Ask the obsidian-markdown skill for the correct syntax to create a wikilink to a heading in another note, or to format a nested callout that works in your Obsidian vault.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I create a wikilink to a specific block reference in Obsidian?

Obsidian nested callouts require specific syntax formatting that differs from standard markdown blockquotes. This Skill provides the precise callout syntax, including nested variants, validated against your vault to ensure proper rendering.

Why does my YAML frontmatter not format correctly in Obsidian?

Obsidian wikilink aliases use the pipe character format [[note|alias]] which differs from standard markdown links. This Skill provides exact wikilink syntax with aliases and heading anchors validated by inspecting your actual vault structure.

How do I embed a note inside another note using Obsidian markdown?

Yes, Obsidian markdown differs from CommonMark by adding custom syntax for wikilinks, callouts, embeds, and frontmatter. This Skill explicitly distinguishes Obsidian-specific behavior from CommonMark defaults to prevent syntax conflicts.

What is the correct way to format nested tags in Obsidian?

Yes, this Skill uses built-in vault inspection tools to verify note-specific syntax rules before providing recommendations. This ensures the syntax guidance matches your actual vault structure rather than generic defaults.