obsidian-markdown

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

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/chisuhua/home --skill obsidian-markdown-chisuhua
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/chisuhua/home/tree/main/.config/opencode/skills/obsidian-markdown
Command: npx skills add https://github.com/chisuhua/home --skill obsidian-markdown-chisuhua

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 using the wrong syntax produces broken links or unrendered content in the vault. ## Core Features & Use Cases - Wikilinks and Embeds: Create internal note links with heading and block references, and embed notes, images, PDFs, and other media inline. - Callouts and Properties: Add typed callout blocks with folding and custom titles, plus frontmatter properties like tags, aliases, and cssclasses. - Obsidian Extensions: Use comments, highlights, LaTeX math, Mermaid diagrams, footnotes, and nested tags that render natively in Obsidian. - Use Case: When drafting a project note in an Obsidian vault, generate a complete document with frontmatter, task lists, links to related notes, an embedded architecture diagram, and a highlighted deadline callout. ## Quick Start Create an Obsidian note for my project with frontmatter tags, a warning callout for the deadline, and wikilinks to my related 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 wikilinks in Obsidian notes?▼

Wikilinks use double brackets like [[Note Name]] to link notes within a vault. Add a pipe for custom display text ([[Note|Text]]), a hash for headings ([[Note#Heading]]), or ^block-id for block-level links.

How to embed images and PDFs in Obsidian Markdown?▼

Prefix any wikilink with an exclamation mark to embed content, such as ![[image.png]] or ![[document.pdf#page=3]]. You can set image width with a pipe parameter like ![[image.png|300]].

What callout types does Obsidian support?▼

Obsidian supports callout types including note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, and todo. Add a minus or plus after the type to make callouts foldable, like > [!faq]- for collapsed by default.

Should I use wikilinks or Markdown links in Obsidian?▼

Use wikilinks ([[Note]]) for notes inside the vault because Obsidian automatically updates them when files are renamed. Use standard Markdown links ([text](url)) only for external URLs.

Why is my Obsidian note not rendering correctly?▼

Rendering issues usually come from malformed frontmatter, incorrect callout syntax, or broken wikilink targets. Verify the note in Obsidian's reading view and check that block IDs for lists and quotes sit on a separate line after the block.