obsidian-markdown

Standardize Obsidian Flavored Markdown syntax for wikilinks, embeds, callouts, and frontmatter.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/deox420/second-brain --skill obsidian-markdown-deox420
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/deox420/second-brain/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/deox420/second-brain --skill obsidian-markdown-deox420

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a reliable reference for Obsidian Flavored Markdown syntax to prevent broken links, misformatted frontmatter, and embedding errors when creating or editing wiki pages.

Core Features & Use Cases

  • Wikilinks, embeds, callouts, properties, tags, and math styling in Obsidian Markdown.
  • Serves as a fallback reference when kepano's authoritative substrate is unavailable, ensuring consistent syntax guidance across agents.
  • Use Case: When writing wiki pages, consult this skill to format links, embeds, callouts, and frontmatter correctly and predictably.

Quick Start

Write a new wiki page that includes a wikilink to [[Another Note]] and an embedded image ![[image.png]] with a frontmatter section.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I format YAML frontmatter for Obsidian notes without syntax errors?

To format Obsidian Markdown correctly, use wikilinks like [[Note]], embeds like ![[image.png]], and callout blocks while maintaining strict YAML frontmatter. Following these standardized syntax rules prevents broken links and misformatted properties when writing wiki pages.

How do wikilinks and embeds work in Obsidian Markdown?

Wikilinks in Obsidian Markdown use the [[Note Name]] syntax to connect notes, while embeds use ![[file.png]] to display images or other content inline. This syntax standardizes internal linking and embedding to prevent broken references within your wiki pages.

Can I write math formulas and Mermaid diagrams using Obsidian Flavored Markdown?

Yes, Obsidian Flavored Markdown supports math styling and Mermaid diagram rendering within notes. You can standardize mathematical notation and create flowcharts directly in your text, ensuring complex visual and structural data formats predictably display without formatting errors.

Does this Obsidian Markdown reference work without the kepano substrate available?

Yes, this reference serves as a reliable fallback when the kepano authoritative substrate is unavailable. It independently defines and enforces Obsidian Flavored Markdown syntax rules, ensuring consistent formatting guidance for wikilinks, callouts, and frontmatter across agents.

Why are my Obsidian callouts and tags not rendering correctly?

Callouts and tags fail to render when Obsidian Flavored Markdown syntax is applied incorrectly. Standardizing your callout block formatting and tag placement ensures these elements display predictably and prevents misformatted content within your wiki pages.