obsidian-markdown

Write valid Obsidian-Flavored Markdown with wikilinks, embeds, callouts, and frontmatter properties.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing notes for Obsidian requires syntax beyond standard Markdown—wikilinks, embeds, callouts, properties, and comments—and getting any of it wrong breaks links, embeds, or rendering inside a vault. This Skill provides the exact Obsidian-Flavored Markdown syntax so notes render correctly the first time. ## Core Features & Use Cases - Wikilinks and Embeds: Create internal links with [[Note]], heading and block references, and embed notes, images, PDFs, and audio with ![[embed]] syntax. - Callouts and Properties: Add foldable callouts with > [!type] and define frontmatter properties like tags, aliases, and cssclasses. - Extended Syntax: Use comments, highlights, LaTeX math, Mermaid diagrams, and footnotes specific to Obsidian. - Use Case: When asked to turn meeting notes into an Obsidian note, the Skill produces a file with proper frontmatter, wikilinks to related notes, a warning callout for deadlines, and an embedded architecture diagram. ## Quick Start Ask the agent to write the current content as an Obsidian note with frontmatter properties, wikilinks to related notes, and a callout for key points.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I create internal links in Obsidian notes?

Use wikilink syntax with double brackets, such as [[Note Name]], to link notes inside a vault. Add a pipe for custom display text like [[Note Name|Display Text]], or target a heading with [[Note Name#Heading]] or a block with [[Note Name#^block-id]].

How do I add a callout in Obsidian Markdown?

Write a blockquote starting with > [!type], for example > [!note] or > [!warning]. Add a custom title after the type, and append a minus sign for collapsed-by-default or a plus sign for expanded foldable callouts.

What frontmatter properties does Obsidian support?

Obsidian supports YAML frontmatter with text, number, checkbox, date, datetime, list, and link property types. Default properties include tags for searchable labels, aliases for alternative note names, and cssclasses for styling the note.

When should I use wikilinks versus Markdown links in Obsidian?

Use [[wikilinks]] for notes within the vault because Obsidian tracks renames automatically and updates links. Reserve standard [text](url) Markdown links for external URLs only.

Can I embed images and PDFs in an Obsidian note?

Yes, prefix any wikilink with an exclamation mark, such as ![[image.png]] or ![[document.pdf#page=3]]. You can set image width with ![[image.png|300]] and embed audio, video, or search query results the same way.

When should I use obsidian-cli instead of writing Markdown directly?

Use obsidian-cli when the action needs a running Obsidian instance, such as searching the vault, opening a note, or reloading plugins. Writing or editing note content itself only requires the Markdown syntax from this Skill.