obsidian

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

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/harunjeylan/pi-agent --skill obsidian-harunjeylan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/harunjeylan/pi-agent/tree/main/skills/obsidian
Command: npx skills add https://github.com/harunjeylan/pi-agent --skill obsidian-harunjeylan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing notes for Obsidian requires knowledge of its extended Markdown syntax, including wikilinks, embeds, callouts, and YAML properties, which differ from standard Markdown and are easy to get wrong. ## Core Features & Use Cases - Wikilinks and Block References: Create internal note links with custom display text, heading anchors, and block IDs for connected vault structures. - Embeds and Callouts: Embed notes, images, PDFs, and audio inline, and add foldable callouts in 13 supported types for highlighted content. - Properties and Frontmatter: Define tags, aliases, dates, and custom properties in YAML frontmatter for search and organization. - Use Case: When drafting a project note in Obsidian, generate a complete document with frontmatter, task lists, callouts for deadlines, embedded diagrams, and links to related meeting notes. ## Quick Start Create an Obsidian note about my project plan with frontmatter tags, a warning callout for the deadline, and wikilinks to my meeting notes.

Frequently Asked Questions about obsidian

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

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

Use wikilinks with 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 a caret for block references ([[Note#^block-id]]).

How do I add callouts in Obsidian Markdown?▼

Write a blockquote starting with > [!type] where type is note, tip, warning, info, or one of 13 supported types. Add a custom title after the type, and use a minus or plus sign after the bracket to make the callout foldable.

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

Wikilinks ([[Note]]) connect notes within the vault and are automatically updated when notes are renamed. Standard Markdown links ([text](url)) are intended for external URLs and do not track renames.

Can I embed images and PDFs in Obsidian notes?▼

Yes, prefix any wikilink with an exclamation mark to embed content, such as ![[image.png|300]] for a resized image or ![[document.pdf#page=3]] for a specific PDF page. Audio files and search query results can also be embedded.

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