obsidian-markdown

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

Updated May 27, 2026
One-click install
npx skills add https://github.com/AdielMag/ClashUp --skill obsidian-markdown-adielmag
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/AdielMag/ClashUp/tree/main/.claude/skills/obsidian-markdown
Command: npx skills add https://github.com/AdielMag/ClashUp --skill obsidian-markdown-adielmag

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, block references, and YAML properties—and getting these wrong produces broken links or unrendered content in the vault. ## Core Features & Use Cases - Wikilinks and Embeds: Create internal note links, heading and block references, and embed notes, images, PDFs, audio, and search results with ![[...]] syntax. - Callouts and Properties: Add foldable, nested callouts of all supported types and structured YAML frontmatter with tags, aliases, dates, and custom properties. - Obsidian-Only Syntax: Apply highlights, comments, footnotes, LaTeX math, and Mermaid diagrams that render correctly in Obsidian. - Use Case: When drafting a project note in an Obsidian vault, generate a complete file with frontmatter, task lists, a warning callout for deadlines, an embedded architecture diagram, and links to related meeting notes. ## Quick Start Create an Obsidian note for my project with frontmatter tags, a warning callout for the deadline, and wikilinks to my meeting notes.

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 between Obsidian notes?▼

Use wikilink syntax with double brackets, such as [[Note Name]], optionally with custom display text like [[Note Name|Display Text]]. You can also link to specific headings with [[Note Name#Heading]] or blocks with [[Note Name#^block-id]].

How do I embed images or PDFs in an Obsidian note?▼

Prefix a wikilink with an exclamation mark, such as ![[image.png]] or ![[document.pdf#page=3]]. Images support sizing like ![[image.png|300]] for width, and PDFs support page and height parameters.

What callout types does Obsidian support?▼

Obsidian supports note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example, and quote callouts, each with aliases. Callouts can be foldable using - or + after the type and can be nested inside each other.

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. Use standard [text](url) Markdown links only for external URLs outside the vault.

What characters are allowed in Obsidian tags?▼

Tags can contain letters in any language, numbers (not as the first character), underscores, hyphens, and forward slashes for nesting like #nested/tag. Tags can be written inline or listed under the tags property in frontmatter.