obsidian-markdown

Installation
Summary

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, and properties.

  • Covers Obsidian-specific syntax extensions: wikilinks ([[Note]]), embeds (![[Note]]), callouts (> [!type]), block IDs, and frontmatter properties
  • Supports internal vault linking with automatic rename tracking, plus embeds for notes, images, PDFs, and external media
  • Includes callout types (note, warning, tip, danger, etc.), inline and block comments, highlights, LaTeX math, and Mermaid diagrams
  • Assumes standard Markdown knowledge (headings, lists, tables, code blocks); focuses only on Obsidian extensions
SKILL.md

Obsidian Flavored Markdown Skill

Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.

Workflow: Creating an Obsidian Note

  1. Add frontmatter with properties (title, tags, aliases) at the top of the file. See PROPERTIES.md for all property types.
  2. Write content using standard Markdown for structure, plus Obsidian-specific syntax below.
  3. Link related notes using wikilinks ([[Note]]) for internal vault connections, or standard Markdown links for external URLs.
  4. Embed content from other notes, images, or PDFs using the ![[embed]] syntax. See EMBEDS.md for all embed types.
  5. Add callouts for highlighted information using > [!type] syntax. See CALLOUTS.md for all callout types.
  6. Verify the note renders correctly in Obsidian's reading view.

When choosing between wikilinks and Markdown links: use [[wikilinks]] for notes within the vault (Obsidian tracks renames automatically) and [text](url) for external URLs only.

Internal Links (Wikilinks)

[[Note Name]]                          Link to note
Related skills
Installs
29.8K
GitHub Stars
30.5K
First Seen
Jan 20, 2026