obsidian-markdown

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

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill obsidian-markdown-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/obsidian-markdown
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill obsidian-markdown-miyake-san

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 breaks rendering, linking, and graph view in your vault. This Skill provides the exact Obsidian Flavored Markdown rules so notes render correctly and stay connected. ## Core Features & Use Cases - Wikilinks and Embeds: Create internal links with [[Note]], heading and block references, and embed notes, images, PDFs, audio, and search results with ![[embed]] syntax. - Callouts and Properties: Add foldable callouts with > [!type] syntax and structured YAML frontmatter properties like tags, aliases, and cssclasses. - Obsidian-Only Extensions: Use comments (%%hidden%%), highlights (==text==), footnotes, LaTeX math, and Mermaid diagrams that link to notes. - Use Case: When drafting a project note in your Obsidian vault, generate a complete document with frontmatter properties, task lists, a warning callout for deadlines, an embedded architecture diagram, and wikilinks to related meeting notes. ## Quick Start Create an Obsidian note for my project kickoff 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 in Obsidian notes?

Use wikilink syntax with double brackets like [[Note Name]] to link between notes in your vault. Add a pipe for custom display text ([[Note|Text]]), a hash for headings ([[Note#Heading]]), or a caret for block references ([[Note#^block-id]]).

How do I add callouts in Obsidian Markdown?

Use blockquote syntax with a type marker: > [!note] followed by indented content. Obsidian supports types like tip, warning, info, danger, and example, and you can make callouts foldable by appending - (collapsed) or + (expanded) after the type.

What is the difference between wikilinks and Markdown links in Obsidian?

Wikilinks ([[Note]]) connect notes within your vault and Obsidian automatically updates them when notes are renamed. Standard Markdown links ([text](url)) are for external URLs. Use wikilinks for internal notes and Markdown links for web resources.

Does Obsidian support embedding images and PDFs in notes?

Yes, prefix any wikilink with an exclamation mark to embed content: ![[image.png]] for images (with optional size like ![[image.png|300]]) and ![[document.pdf#page=3]] for specific PDF pages. Audio, video, and search query embeds are also supported.

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 nested tags like #project/active. Tags can be written inline in the note body or listed in frontmatter under the tags property.