obsidian-markdown

Generate Obsidian Flavored Markdown with wikilinks, embeds, callouts, and YAML frontmatter.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill obsidian-markdown-gabrielcardosodeaguiar45-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima/tree/main/obsidian-markdown
Command: npx skills add https://github.com/gabrielcardosodeaguiar45-oss/claude-skills-azevedolima --skill obsidian-markdown-gabrielcardosodeaguiar45-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian users need a reliable way to write Markdown that also works with Obsidian-specific features like wikilinks, embeds, callouts, properties, and tags without breaking note rendering.

Core Features & Use Cases

  • Wikilinks & internal navigation: Create vault links using [[Note]], link to headings, and reference block IDs for precise connections between notes.
  • Embeds & rich note inclusion: Inline-embed notes, headings, images, PDFs, lists, and query results using ![[...]] syntax.
  • Obsidian UI elements in Markdown: Add callouts (> [!type]) and properties via YAML frontmatter to support structured workflows.
  • Use Case: When drafting a project note, you can add frontmatter tags/status/aliases, connect it to related notes with wikilinks, embed key diagrams or PDFs, and highlight important deadlines using callouts.

Quick Start

Ask for Obsidian Flavored Markdown for a note named "Project Alpha" that includes YAML frontmatter (title, date, tags), uses wikilinks to reference two related notes, adds a warning callout with a custom title, and embeds an image file using the appropriate ![[image.png|width]] syntax.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I write Obsidian Markdown with wikilinks and callouts?

Obsidian Markdown uses `[[...]]` for wikilinks and `> [!type]` for callouts. You can link notes, reference headings or block IDs, and highlight info using these syntax rules so notes render properly.

What is the syntax for embedding images and PDFs in Obsidian notes?

To embed media in Obsidian notes, use the `![[...]]` syntax. This allows you to inline-embed images, PDFs, notes, headings, lists, and query results directly within your markdown content.

How do I add YAML frontmatter properties and tags to an Obsidian note?

Obsidian notes support structured metadata via YAML frontmatter properties. You add frontmatter at the top of your note to define tags, status, aliases, and other properties to support structured workflows.

Can I link to a specific heading or block ID in another Obsidian note?

Yes, you can create precise connections between notes in Obsidian by using wikilinks to reference specific headings and block IDs. This uses the `[[Note]]` syntax extended with heading or block anchors.

Does standard Markdown support Obsidian callouts and embeds?

Standard Markdown does not support Obsidian-specific features like callouts (`> [!type]`) and embeds (`![[...]]`). You need Obsidian Flavored Markdown to ensure these extensions render properly in your vault.

How do I structure a project note with Obsidian properties, links, and embeds?

Draft a project note by adding YAML frontmatter for tags and status, use wikilinks to connect related notes, embed key diagrams or PDFs with `![[...]]`, and highlight deadlines using callouts like `> [!warning]`.