obsidian-markdown

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

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/ryan-ressmeyer/agent-config --skill obsidian-markdown-ryan-ressmeyer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/ryan-ressmeyer/agent-config/tree/main/skills/obsidian-markdown
Command: npx skills add https://github.com/ryan-ressmeyer/agent-config --skill obsidian-markdown-ryan-ressmeyer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian users often struggle to consistently structure notes with proper frontmatter, wikilinks, embeds, callouts, and other Obsidian-specific features. This Skill provides a practical guide to creating and editing valid Obsidian Flavored Markdown that renders correctly in Obsidian and supports efficient navigation and metadata management.

Core Features & Use Cases

  • Supports frontmatter properties (title, tags, aliases) and Obsidian syntax for linking notes, embedding content, and applying callouts.
  • Demonstrates how to reference images, PDFs, and other notes with wikilinks and embeds to build a connected vault.
  • Use Case: draft a new vault note with consistent metadata and cross-note references.

Quick Start

Create a new Obsidian note by adding a frontmatter block and then write content using Obsidian syntax.

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 notes with proper frontmatter and wikilinks?

Obsidian markdown notes require a frontmatter block for metadata like title and tags, followed by content using wikilinks for cross-note references. This approach ensures valid rendering and connected navigation across your vault.

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

Obsidian markdown uses specific embed syntax within wikilinks to display images, PDFs, and other notes. This builds a connected vault by rendering attached content directly within your note body.

How do I add callouts and properties to an existing Obsidian note?

Adding callouts and properties to Obsidian notes involves inserting specific markdown syntax for styled blocks and updating frontmatter metadata. This revision process ensures compatibility with Obsidian rendering rules.

Does this approach to Obsidian markdown work for validating note structure across an entire vault?

Yes, validating Obsidian markdown checks notes for proper frontmatter, wikilinks, and embeds across a vault. This ensures compatibility with Obsidian rendering rules and supports efficient metadata management.

What is the best way to manage Obsidian frontmatter properties like tags and aliases?

Managing Obsidian frontmatter properties requires consistently defining title, tags, and aliases at the top of markdown files. This ensures proper metadata management and supports accurate note searching and organization.