obsidian-markdown

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of writing Markdown that looks correct in Obsidian when you need features beyond standard CommonMark or GFM, such as wikilinks, callouts, embeds, properties, and other Obsidian-specific syntax.

Core Features & Use Cases

  • Obsidian Flavored Markdown support: Generates syntax for wikilinks, headings, emphasis, strikethrough, highlights, and escaping rules that match Obsidian’s rendering behavior.
  • Linking that works in your vault: Creates internal links to notes, headings, and blocks using the exact [[...]] formats Obsidian expects, including search-style links.
  • Obsidian-native blocks & metadata: Produces callouts, YAML frontmatter properties (tags, aliases, CSS classes, statuses, dates), and embed syntax for files, images, PDFs, and linked query results.
  • Use Case: Draft a research note in your vault with wikilinks to related pages, a callout section summarizing findings, and correct frontmatter properties so Obsidian can index and style it properly.

Quick Start

Create Obsidian-compatible Markdown for my note about “Project Atlas”, including YAML frontmatter with tags, a wikilink to “Resources”, a callout with the key takeaway, and an embed section for a related PDF.

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 correct wikilinks and callouts?

Obsidian markdown requires specific syntax for wikilinks and callouts to render properly. You can generate Obsidian-flavored markdown that uses exact [[...]] formats for internal links and correct block formatting to ensure your vault notes index and display correctly.

What is the correct frontmatter format for Obsidian vault notes?

Obsidian frontmatter uses YAML properties to define metadata like tags, aliases, CSS classes, statuses, and dates. Generating correct YAML frontmatter ensures Obsidian can properly index, query, and style your notes within the vault environment.

How do I embed a PDF or image inside an Obsidian note?

To embed a PDF or image in Obsidian, you use specific embed syntax for files and linked content. This generates the correct embedded content links so that documents and query results display directly within your markdown notes.

Can I use standard CommonMark or GFM syntax for Obsidian research notes?

Standard CommonMark or GFM lacks Obsidian-specific syntax for wikilinks, callouts, and properties. To structure research notes with internal links and frontmatter metadata, you need Obsidian-flavored markdown to ensure proper rendering and vault indexing.

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

Linking to specific headings or blocks in Obsidian uses exact [[...]] search-style link formats. Generating these precise internal links ensures your markdown correctly navigates to targeted sections within your vault notes.

Why does my markdown callout block not render in Obsidian?

Markdown callouts fail to render in Obsidian when the syntax does not match the application's deterministic formatting rules. Generating Obsidian-native callout blocks ensures your summaries and key takeaways display correctly without formatting errors.