obsidian-markdown

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

Updated May 17, 2026
One-click install
npx skills add https://github.com/aokazaki-olp/electron-prototype --skill obsidian-markdown-aokazaki-olp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/aokazaki-olp/electron-prototype/tree/main/.agents/skills/obsidian-markdown
Command: npx skills add https://github.com/aokazaki-olp/electron-prototype --skill obsidian-markdown-aokazaki-olp

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, audio, and search results inline. - Callouts and Properties: Add foldable callouts of 13 supported types and YAML frontmatter properties like tags, aliases, and cssclasses. - Obsidian-Only Syntax: Use highlights, comments, footnotes, LaTeX math, and Mermaid diagrams that render in Obsidian's reading view. - Use Case: When drafting a project note in an Obsidian vault, generate frontmatter with tags and aliases, link to related meeting notes with [[Note#Heading]], embed an architecture diagram, and highlight deadlines in a warning callout. ## Quick Start Create an Obsidian note for my project kickoff with frontmatter tags, a link to my meeting notes, an embedded diagram, and a warning callout for the deadline.

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]], 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]] and a block with [[Note Name#^block-id]].

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

Prefix a wikilink with an exclamation mark to embed content, such as ![[image.png]] or ![[document.pdf#page=3]]. Images accept size parameters like ![[image.png|300]] for width, and external images use standard Markdown image syntax.

What callout types does Obsidian support?▼

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

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.

What characters are allowed in Obsidian tags?▼

Obsidian 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.