obsidian-markdown

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

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill obsidian-markdown-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/obsidian-markdown
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill obsidian-markdown-traymachi

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 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, Mermaid diagrams, and LaTeX math that render natively in Obsidian. - Use Case: When drafting a project note in an Obsidian vault, generate valid frontmatter with tags and aliases, link to related meeting notes, embed an architecture diagram, and highlight a deadline in a warning callout. ## Quick Start Create an Obsidian note for my project with frontmatter tags, a wikilink 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 in Obsidian notes?

Use wikilink syntax with double brackets, such as [[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 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 ![[image.png|300]] and embed specific note sections with ![[Note#Heading]].

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, each with aliases. Add a minus sign after the type for collapsed-by-default foldable callouts, or a plus sign for expanded.

Should I use wikilinks or Markdown links in Obsidian?

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

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.