How do I install the Obsidian Markdown Mastery skill?

Run npx skillmds@latest add richfrem/obsidian-markdown-mastery-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Markdown Mastery safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Markdown Mastery?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Markdown Mastery free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Markdown Mastery?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Markdown Mastery by richfrem

Name: Obsidian Markdown Mastery
Author: richfrem

Obsidian Markdown Mastery

Core markdown syntax skill for Obsidian. Enforces strict parsing and authoring of Obsidian proprietary syntax (Wikilinks, Blocks, Headings, Aliases, Embeds, Callouts). Use when reading, writing, or validating Obsidian-flavored markdown.

richfrem Updated Sep 21, 2026

File contents

Obsidian Markdown Mastery (Protocol 129 COMPLIANT)

Status: Active Author: Obsidian Integration Plugin Domain: Obsidian Integration

Core Mandate

The obsidian-markdown-mastery skill is responsible for the exact formatting, extraction, and validation of Obsidian-flavoured Markdown. It provides the low-level string manipulation that allows higher-order agents (like the Graph Traverser or JSON Canvas Architect) to safely interpret relational links without breaking the .md Vault.

CRITICAL ARCHITECTURAL RULE: All vault data manipulation MUST occur through deterministic Python scripts rather than agent-prompted regex. This skill defines the obsidian-parser module that performs these deterministic actions.

Agnosticism Enforcement: This module knows NOTHING about project-specific protocols, persistence layers, or external services. It only knows how to parse text into valid Obsidian links and block-quotes. Project-specific configuration (vault paths, injection points) is managed via the OBSIDIAN_VAULT_PATH environment variable.

Available Commands

Analyze Markdown Content

Extracts all Obsidian-specific metadata (links, embeds, blocks) from a given markdown file or string. Command: python plugins/obsidian-integration/obsidian-parser/parser.py analyze --file <path_to_md>

Inject Callout

Wraps a target text block in an Obsidian-flavored callout. Command: python plugins/obsidian-integration/obsidian-parser/parser.py callout --type <type> --title <title> --text <content>

The Parsed Syntax (Data Dictionary)

When manipulating strings via this module, the following formats are enforced:

1. Linking and Aliasing

Standard Link: [[Note Name]]
Heading Link: [[Note Name#Heading Name]]
Block Link: [[Note Name#^block-id]]
Aliased Link: [[Note Name|Display Text]]

2. Transclusion (Embeds)

Standard Embed: ![[Note Name]] (Note the leading !)
(The parser specifically categorizes these differently so graph mappers know they are transclusions, not semantic links).

3. Callouts

Syntax:

> [!type] Title
> Content block goes here.

Supported Types: info, warning, error, success, note.

Configuration Environment Variable

Other tools (such as protocol-manager and chronicle-manager) rely on the unified OBSIDIAN_VAULT_PATH environment variable to discover where the root of the Obsidian Vault resides. If missing, it defaults to the project root.

---name: obsidian-markdown-mastery-3description: Core markdown syntax skill for Obsidian. Enforces strict parsing and authoring of Obsidian proprietary syntax (Wikilinks, Blocks, Headings, Aliases, Embeds, Callouts). Use when reading, writing, or validating Obsidian-flavored markdown.---# Obsidian Markdown Mastery (Protocol 129 COMPLIANT)**Status:** Active**Author:** Obsidian Integration Plugin**Domain:** Obsidian Integration## Core MandateThe `obsidian-markdown-mastery` skill is responsible for the exact formatting, extraction, and validation of Obsidian-flavoured Markdown. It provides the low-level string manipulation that allows higher-order agents (like the Graph Traverser or JSON Canvas Architect) to safely interpret relational links without breaking the `.md` Vault.> **CRITICAL ARCHITECTURAL RULE:**> All vault data manipulation MUST occur through deterministic Python scripts rather than agent-prompted regex. This skill defines the `obsidian-parser` module that performs these deterministic actions.> > *Agnosticism Enforcement*: This module knows NOTHING about project-specific protocols, persistence layers, or external services. It only knows how to parse text into valid Obsidian links and block-quotes. Project-specific configuration (vault paths, injection points) is managed via the `OBSIDIAN_VAULT_PATH` environment variable.## Available Commands### Analyze Markdown ContentExtracts all Obsidian-specific metadata (links, embeds, blocks) from a given markdown file or string.**Command**: `python plugins/obsidian-integration/obsidian-parser/parser.py analyze --file <path_to_md>`### Inject CalloutWraps a target text block in an Obsidian-flavored callout.**Command**: `python plugins/obsidian-integration/obsidian-parser/parser.py callout --type <type> --title <title> --text <content>`## The Parsed Syntax (Data Dictionary)When manipulating strings via this module, the following formats are enforced:### 1. Linking and Aliasing* **Standard Link**: `[[Note Name]]`* **Heading Link**: `[[Note Name#Heading Name]]`* **Block Link**: `[[Note Name#^block-id]]`* **Aliased Link**: `[[Note Name|Display Text]]`### 2. Transclusion (Embeds)* **Standard Embed**: `![[Note Name]]` (Note the leading `!`)* *(The parser specifically categorizes these differently so graph mappers know they are transclusions, not semantic links).*### 3. Callouts* **Syntax**: ```markdown > [!type] Title > Content block goes here. ```* **Supported Types**: `info`, `warning`, `error`, `success`, `note`.## Configuration Environment VariableOther tools (such as `protocol-manager` and `chronicle-manager`) rely on the unified `OBSIDIAN_VAULT_PATH` environment variable to discover where the root of the Obsidian Vault resides. If missing, it defaults to the project root.

Frequently asked questions