obsidian-markdown

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

Updated May 10, 2026
One-click install
npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill obsidian-markdown-mateus2411
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/Mateus2411/Hermes-PersonalBot/tree/main/skills/obsidian-skills/skills/obsidian-markdown
Command: npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill obsidian-markdown-mateus2411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian users need a reliable way to write and edit Obsidian Flavored Markdown so notes render correctly with wikilinks, embeds, callouts, properties, tags, and other Obsidian-specific syntax.

Core Features & Use Cases

  • Wikilinks & Internal Navigation: Create links between notes, headings, and block IDs using Obsidian’s [[...]] syntax, including #^block-id anchors.
  • Embeds & Visual Referencing: Inline embed notes, headings, images, PDFs (including page/height), and media using ![[...]].
  • Callouts & Frontmatter Properties: Use Obsidian callouts (> [!type]) and YAML frontmatter properties (title, tags, aliases, cssclasses, and custom fields) to make notes scannable and searchable.
  • Tags, Comments, and Extra Formatting: Add inline/nested tags, Obsidian comments, highlights, math (LaTeX), Mermaid diagrams, and footnotes.

Quick Start

Use the Obsidian Markdown skill to create a note with YAML frontmatter, wikilinks like [[Project Alpha]], and a callout like > [!note] Remember to review the latest decisions.

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 correctly?

To write Obsidian markdown, use [[...]] syntax for wikilinks and > [!type] for callouts. This ensures notes render correctly with internal links, block IDs, and formatted admonitions across your vault.

How do I embed images and PDFs inline in Obsidian markdown?

Embed images, PDFs, and media inline in Obsidian markdown using the ![[...]] syntax. You can specify exact pages and heights within the embed brackets to control how visual references display in your notes.

What is the correct YAML frontmatter format for Obsidian properties?

Correct YAML frontmatter for Obsidian properties requires compliant fields like tags, aliases, title, cssclasses, and custom variables at the top of your note. This structured metadata makes notes scannable and searchable within the vault.

Does Obsidian markdown support Mermaid diagrams and LaTeX math?

Obsidian markdown supports Mermaid diagrams and LaTeX math formatting alongside standard text. You can also use inline or nested tags, Obsidian comments, highlights, and footnotes to enhance note structure and visual clarity.

How do I link to a specific block or heading in an Obsidian note?

Link to specific blocks or headings in an Obsidian note using wikilink anchors like [[Note Name#Heading]] or [[Note Name#^block-id]]. This internal navigation syntax connects precise locations within your vault files.

Can I use standard markdown syntax instead of Obsidian wikilinks for internal links?

Obsidian uses its own [[...]] wikilink syntax for internal navigation rather than standard markdown links. Using wikilinks ensures proper rendering of note connections, embeds, and block references specific to the Obsidian vault environment.