obsidian-markdown

Guide Obsidian Flavored Markdown syntax for notes, wikilinks, embeds, and callouts.

Updated Apr 23, 2026

Search Tags:#note-taking #markdown #formatting #obsidian #syntax reference

Ready to run

npx skills add https://github.com/xiang2007/obsidian-vault --skill obsidian-markdown-xiang2007

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/xiang2007/obsidian-vault/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/xiang2007/obsidian-vault --skill obsidian-markdown-xiang2007

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to Obsidian Flavored Markdown, helping users write and format their notes correctly and efficiently.

Core Features & Use Cases

Syntax Reference: Offers detailed information on various Markdown syntax elements, including wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax.
Error Prevention: Helps prevent common formatting errors and broken links in Obsidian notes.
Use Case: When creating or editing a wiki page in Obsidian, this Skill ensures the correct syntax is used, resulting in a well-formatted and functional document.

Quick Start

Use the obsidian-markdown skill to learn how to properly format a new note 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 format Obsidian markdown syntax like wikilinks and callouts correctly?▼

Obsidian markdown formatting requires specific syntax for elements like wikilinks, embeds, and callouts to render properly. Using the correct syntax ensures your notes are well-formatted and functional without broken links.

What is the correct way to write math and properties in Obsidian notes?▼

Writing math and properties in Obsidian notes involves using dedicated markdown syntax tailored for these elements. Proper formatting guarantees that equations and note metadata display correctly within your vault.

Why does my Obsidian markdown keep showing formatting errors and broken links?▼

Obsidian markdown formatting errors and broken links typically occur when wiki page syntax is typed incorrectly. Following a detailed syntax reference helps prevent these common mistakes and ensures proper functionality.

Does Obsidian support standard markdown or do I need special syntax for tags and highlights?▼

Obsidian supports standard markdown but also requires special Obsidian Flavored Markdown syntax for tags, highlights, and embeds. Using the correct syntax reference prevents common formatting errors in your notes.

How do I embed content and use canvas syntax in Obsidian markdown?▼

Embedding content and using canvas syntax in Obsidian markdown requires specific formatting rules to link internal notes and visual boards. Applying the correct syntax ensures proper functionality and avoids broken embeds.