skills.rest
diegocamara89
diegocamara89COMMUNITY
Explore all skills by this author →
GitHub

obsidian-markdown

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

3|3|Updated Apr 5, 2026
Search Tags:#note-taking#markdown#obsidian#frontmatter#wikilinks#callouts#embeds
One-click install
npx skills add https://github.com/diegocamara89/ai-skills-hub --skill obsidian-markdown-diegocamara89
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/diegocamara89/ai-skills-hub/tree/main/all-skills/obsidian-markdown
Command: npx skills add https://github.com/diegocamara89/ai-skills-hub --skill obsidian-markdown-diegocamara89

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many users struggle to author or convert Markdown that takes full advantage of Obsidian's vault features, resulting in broken internal links, incorrect embeds, missing frontmatter properties, and notes that don't render as intended in Obsidian's reading view. This skill provides clear, structured guidance to produce Obsidian-compatible notes that interlink, embed, and surface metadata reliably.

Core Features & Use Cases

  • Wikilinks & Linking: Use [[Note]] and [[Note|Display Text]] forms, heading anchors, and block IDs to create stable internal links that survive renames.
  • Embeds & Media: Embed notes, images, PDFs, audio, and search results using the ![[embed]] syntax and sizing parameters for inline display.
  • Callouts & Highlights: Add foldable and titled callouts with > [!type] syntax for emphasis, warnings, tips, and nested callouts.
  • Frontmatter & Properties: Create YAML frontmatter with title, date, tags, aliases, cssclasses, and other property types for metadata-driven workflows.
  • Advanced Formatting: Support for math (LaTeX), Mermaid diagrams, footnotes, highlights, and comment/hidden blocks for richer notes.
  • Use Cases: Crafting meeting notes that link to decisions, building project documentation with embedded diagrams, or converting exported notes into Obsidian-ready files.

Quick Start

Create a new Obsidian note titled Project Alpha with YAML frontmatter including title and tags, add a wikilink to Meeting Notes, insert a callout for the key deadline, and embed Architecture Diagram.png.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I create Obsidian markdown with wikilinks and YAML frontmatter?▼

To create Obsidian markdown with wikilinks and YAML frontmatter, use the [[Note]] syntax for internal links and add metadata properties like title, tags, and aliases at the top of your .md files to ensure notes render correctly and interlink reliably.

What is the correct syntax to embed images and PDFs in Obsidian notes?▼

The correct syntax to embed images and PDFs in Obsidian notes is the ![[embed]] format, which allows inline display of media and other vault files using specific sizing parameters for your embedded content.

How do I add foldable callouts and warnings in Obsidian markdown?▼

To add foldable callouts and warnings in Obsidian markdown, use the > [!type] syntax to create titled, nested callouts for emphasis, tips, or warnings that render properly in Obsidian's reading view.

Can I convert existing markdown notes into Obsidian-ready files with block IDs and math?▼

Yes, you can convert existing markdown notes into Obsidian-ready files by applying valid Obsidian-specific syntax including block IDs, LaTeX math, Mermaid diagrams, and footnotes to ensure full rendering and linking consistency.

Why do my internal links break when I rename notes in my Obsidian vault?▼

Internal links break when you rename notes if you are not using stable wikilinks with heading anchors and block IDs, which are designed to survive renames and maintain consistent internal linking within your vault.

Does obsidian-markdown support metadata-driven workflows with cssclasses and aliases?▼

Yes, obsidian-markdown supports metadata-driven workflows by generating YAML frontmatter that includes cssclasses, aliases, tags, and other property types to structure your documentation and knowledge base entries effectively.

Related Skills

Explore More Content & Communication Skills→
EvolutionAPIEvolutionAPI
520

obs-obsidian-markdown

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

Official
Intermediate
koukokouko
6

obsidian-markdown

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

Community
Intermediate
jackjin1997jackjin1997
11

obsidian-markdown

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

Community
Intermediate
oldwinteroldwinter
5

obsidian-markdown

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

Community
Basic