obsidian-markdown

Define Obsidian Flavored Markdown syntax rules for wikilinks, embeds, callouts, frontmatter, and tags.

10.6k|1.2k|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/AgriciDaniel/claude-obsidian --skill obsidian-markdown-agricidaniel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/AgriciDaniel/claude-obsidian/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/AgriciDaniel/claude-obsidian --skill obsidian-markdown-agricidaniel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents broken wiki links, malformed frontmatter, and non-rendering callouts by giving you a reliable reference for Obsidian Flavored Markdown syntax.

Core Features & Use Cases

  • Wikilinks & embeds: Create internal links and inline note/image/PDF embeds using Obsidian’s [[...]] and ![[...]] syntax.
  • Callouts: Use the correct callout blockquote format and supported callout types (note, info, warning, etc.).
  • Properties (frontmatter): Write YAML frontmatter in the exact shape Obsidian expects for Properties panels, including correct date formats and quoted wikilinks.
  • Tag syntax & formatting: Apply #tags in the right places (body vs frontmatter) and use common Obsidian extensions like highlights, math, Mermaid, and footnotes.

Quick Start

Refer to obsidian-markdown while creating or editing any wiki page to ensure your wikilinks, embeds, callouts, properties frontmatter, and tags render correctly in Obsidian.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I write Obsidian wikilinks and embeds correctly?

Obsidian wikilinks and embeds use the [[...]] and ![[...]] syntax to create internal links and inline note, image, or PDF embeds. This Skill provides exact syntax rules to ensure your wiki links render properly without breaking.

Why do my Obsidian callouts not render properly?

Obsidian callouts require a specific blockquote format using supported types like note, info, and warning. This Skill defines the exact scannable callout formatting needed to ensure your callout blocks render correctly instead of displaying as plain text.

How do I format YAML frontmatter for Obsidian Properties?

Obsidian Properties frontmatter requires a specific YAML shape, including correct date formats and quoted wikilinks, to populate the Properties panel. This Skill outlines the exact frontmatter constraints to prevent malformed metadata rendering failures.

What is the difference between standard Markdown and Obsidian Flavored Markdown?

Obsidian Flavored Markdown extends standard Markdown with wikilinks, block references, heading anchors, and callouts. This Skill defines the exact deltas and what not to do, reducing rendering and linkage failures in your Obsidian vault.

Where should I place tags in Obsidian frontmatter versus the note body?

Obsidian tag syntax formatting dictates whether #tags belong in the YAML frontmatter or the note body. This Skill provides the correct placement rules and formatting constraints to ensure tags function properly across your vault documents.

Does this Skill support Obsidian extensions like math and Mermaid diagrams?

Yes, this Skill covers common Obsidian extensions including math, Mermaid diagrams, highlights, and footnotes. It provides the syntax rules needed to author these elements correctly within your wiki markdown documents.