obsidian-markdown

Convert standard markdown into Obsidian-compatible documents with wikilinks, embeds, callouts, and frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a step-by-step guide so AI assistants and users never break Obsidian Flavored Markdown when working with wikilinks, embeds, callouts, properties, tags, and embedded files, keeping notes consistent and vault-friendly.

Core Features & Use Cases

  • Obsidian Syntax Mastery: Learn how to write wikilinks, heading links, block references, tags, and properties without errors.
  • Rich Content Support: Understand how to embed notes, images, audio, PDFs, and videos, add callouts with nested or foldable behavior, and create mathematical or diagram content directly in your notes.
  • Structured Note Templates: See examples for tables, task lists, code blocks, footnotes, comments, and full metadata frontmatter to ensure notes stay searchable and interconnected.

Quick Start

Ask obsidian-markdown to rewrite my project overview into Obsidian notes with wikilinks, embeds, callouts, and complete frontmatter metadata.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I convert standard markdown into Obsidian notes with wikilinks and callouts?

To convert standard markdown into Obsidian notes, apply valid Obsidian Flavored Markdown syntax including wikilinks, embeds, callouts, and structured frontmatter to keep notes interconnected and vault-friendly.

What is the correct syntax for block references and embedded media in Obsidian?

Correct syntax for block references and embedded media in Obsidian involves using specific wikilink formats and embed structures to embed notes, images, audio, PDFs, and videos while maintaining valid block IDs.

How do I add structured frontmatter and tags to an Obsidian markdown file?

Adding structured frontmatter and tags to an Obsidian markdown file requires writing valid metadata properties at the top of the note, ensuring notes remain searchable and properly categorized within the vault.

Does Obsidian markdown support mermaid diagrams and math expressions?

Yes, Obsidian markdown supports mermaid diagrams and math expressions, allowing you to create mathematical or diagram content directly in your notes alongside task lists, code blocks, and footnotes.

Why do my wikilinks and callouts break when editing Obsidian vault files?

Wikilinks and callouts break when editing Obsidian vault files due to invalid markdown constructs, meaning you must follow specific Obsidian Flavored Markdown rules for wikilinks, callouts, and block IDs to prevent syntax errors.

Can I create foldable callouts and nested content in Obsidian markdown?

Yes, you can create foldable callouts and nested content in Obsidian markdown by applying specific callout syntax rules, allowing rich note structures with embedded media and block references without errors.