skills.rest
caitengwei
caitengweiCOMMUNITY
Explore all skills by this author →
GitHub

obsidian-markdown

Write Obsidian Flavored Markdown with wikilinks, embeds, callouts, and frontmatter.

6|Updated Mar 21, 2026
Search Tags:#markdown#knowledge management#obsidian#frontmatter#wikilinks#callouts#embeds
One-click install
npx skills add https://github.com/caitengwei/my-skills --skill obsidian-markdown-caitengwei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/caitengwei/my-skills/tree/main/obsidian-skills/skills/obsidian-markdown
Command: npx skills add https://github.com/caitengwei/my-skills --skill obsidian-markdown-caitengwei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you write Obsidian Flavored Markdown consistently so your notes render correctly with Obsidian-specific syntax instead of falling back to plain Markdown.

Core Features & Use Cases

  • Wikilinks and internal navigation: Use [[Note]], heading links, and block IDs to connect notes within your vault.
  • Embeds for inline content: Inline embed notes, headings, images, PDFs, and other supported embed types with ![[...]].
  • Callouts and properties: Add Obsidian callouts (> [!type]) and YAML frontmatter properties for tags, aliases, css classes, and more.

Quick Start

Create a new note file and write Obsidian frontmatter, then add wikilinks, callouts, and any required embeds so the note displays correctly in Obsidian.

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

Obsidian markdown uses specific syntax like `[[wikilinks]]` for internal navigation, `> [!type]` for callouts, and `![[...]]` for embeds. Using these conventions ensures your notes render correctly within your vault instead of falling back to plain markdown.

What is the syntax for embedding images and sections in Obsidian?▼

Obsidian embeds use the `![[...]]` syntax to inline content directly into your notes. You can embed entire notes, specific headings, block IDs, images, and PDFs to consolidate related knowledge without duplicating text.

How do I add frontmatter properties and tags to an Obsidian note?▼

Obsidian frontmatter uses YAML properties at the start of a note to structure metadata. You can define tags, aliases, and CSS classes within this YAML block to organize notes and control their rendering behavior inside the vault.

Can I link to a specific heading or block in another Obsidian note?▼

Yes, Obsidian wikilinks support heading links and block IDs to connect precise sections within your vault. This allows you to target exact paragraphs or headers instead of just linking to the entire note file.

Does plain markdown work the same as Obsidian flavored markdown in my vault?▼

Plain markdown lacks Obsidian's internal linking and embedding features, causing notes to render without vault-specific navigation or inline content. Obsidian flavored markdown requires `[[wikilinks]]` and `![[embeds]]` to function correctly.

Related Skills

Explore More Content & Communication Skills→
dustinliudustinliu

writing-note

Manage markdown notes in an Obsidian vault with YAML frontmatter and wikilinks.

Community
Intermediate
dull-birddull-bird
6

do.parse-knowledge

Parse unstructured text into linked Obsidian research notes and wiki concept pages.

Community
Intermediate
jwintzjwintz
24

Vault Sanitization

Sanitize Obsidian vault frontmatter by fixing unescaped quotes and malformed YAML.

Community
Intermediate
466852675466852675

obsidian-markdown

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

Community
Basic