obsidian-markdown

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

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill obsidian-markdown-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/obsidian-markdown
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill obsidian-markdown-tamagusko

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, nested callouts of 13 supported types and YAML frontmatter properties including tags, aliases, and cssclasses. - Obsidian-Specific Formatting: Use highlights, comments, footnotes, LaTeX math, and Mermaid diagrams that render correctly in Obsidian. - Use Case: When drafting a project note in an Obsidian vault, generate frontmatter with tags and aliases, link related meeting notes with wikilinks, embed an architecture diagram, and highlight deadlines in a warning callout. ## Quick Start Ask the assistant to create an Obsidian note about a topic with frontmatter tags, wikilinks to related notes, and a callout highlighting the key takeaway.

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]], optionally with custom display text like [[Note Name|Display Text]]. You can also link to specific headings with [[Note Name#Heading]] or blocks with [[Note Name#^block-id]].

How do I embed images or PDFs in Obsidian Markdown?

Prefix any wikilink with an exclamation mark to embed content, such as ![[image.png]] or ![[document.pdf#page=3]]. Images support sizing with ![[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. Callouts use the > [!type] syntax and can be foldable with a minus or plus suffix.

When should I use wikilinks versus Markdown links in Obsidian?

Use [[wikilinks]] for notes within the vault because Obsidian tracks renames automatically and updates all references. Use standard [text](url) Markdown links only for external URLs outside the vault.

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 work both inline in note text and in frontmatter under the tags property.