obsidian-markdown-mastery

Parse and validate Obsidian Markdown links, embeds, and callouts.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill obsidian-markdown-mastery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown-mastery
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/obsidian-wiki-engine/skills/obsidian-markdown-mastery
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill obsidian-markdown-mastery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures consistent Obsidian Markdown syntax by enforcing strict parsing, extraction, and validation of wikilinks, blocks, headings, aliases, embeds, and callouts.

Core Features & Use Cases

  • Deterministic parsing of Obsidian syntax with the obsidian-parser module (no ad-hoc regex).
  • Validation and normalization of links, embeds, and callouts to preserve vault integrity.
  • CLI tools to analyze content and audit vault notes for correctness, across large Obsidian vaults.

Quick Start

Analyze a Markdown file by providing its path to the parser to extract Obsidian links, embeds, and callouts.

Frequently Asked Questions about obsidian-markdown-mastery

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

FAQPage Schema
How do I validate Obsidian markdown links and callouts across a large vault?

Obsidian markdown links and callouts are validated by running CLI tools that enforce strict parsing and normalization of wikilinks, embeds, and blocks to prevent malformed syntax and preserve vault integrity.

What is the best way to parse wikilinks and embeds without using ad-hoc regex?

The best way to parse wikilinks and embeds without ad-hoc regex is using deterministic parsing modules that extract and validate Obsidian syntax directly, ensuring consistent syntax extraction across notes.

Do I need Python to extract Obsidian markdown blocks and headings?

Yes, extracting Obsidian markdown blocks and headings requires Python 3.8 or higher, as the deterministic parser operates via a Python module requiring the OBSIDIAN_VAULT_PATH environment variable.

Can I audit Obsidian vault notes for broken links and malformed blocks automatically?

Yes, Obsidian vault notes can be automatically audited for broken links and malformed blocks using CLI tools that apply deterministic parsing to analyze content correctness at file and vault-wide levels.

Why does my Obsidian markdown parsing fail when checking callouts and aliases?

Obsidian markdown parsing fails when checking callouts and aliases if you use ad-hoc regex or external services instead of deterministic parsing, which strictly validates syntax to prevent inconsistencies.