obsidian-markdown

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes friction when creating and editing Obsidian vault notes by providing a reliable way to use Obsidian-specific Markdown features correctly.

Core Features & Use Cases

  • Obsidian-specific syntax support: wikilinks, embeds, callouts, properties/frontmatter, tags, comments, highlights, math, Mermaid diagrams, and footnotes.
  • Vault-friendly linking: choose wikilinks for intra-vault relationships so notes and headings stay robust during renames and navigation.
  • Structured note metadata: add and use frontmatter properties (such as title, date, tags, aliases, and CSS classes) to keep notes searchable and consistent.
  • Use case: turn a course reflection into a navigable Obsidian page by linking it to relevant readings with wikilinks, adding callouts for key takeaways, embedding a diagram image, and including property tags for retrieval.

Quick Start

Create an Obsidian note that includes frontmatter properties, wikilinks to related vault notes, an inline embed, and at least one callout for a key insight.

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

To write Obsidian notes correctly, use wikilinks for intra-vault relationships to keep notes robust during renames, and add YAML frontmatter properties like title, date, and tags to keep notes searchable and consistent.

What is the best way to format Obsidian callouts and embeds in markdown?

The best way to format Obsidian callouts and embeds is to use supported callout and formatting conventions for reliable rendering, ensuring inline embeds and key insights display correctly inside the vault.

Can I use Mermaid diagrams and footnotes in Obsidian flavored markdown?

Yes, you can use Mermaid diagrams and footnotes in Obsidian flavored markdown. The syntax supports common extensions including math, highlights, comments, and Mermaid diagrams for rich note authoring.

How do I add YAML frontmatter properties to an Obsidian vault note?

You add YAML frontmatter properties to an Obsidian vault note by including valid metadata such as title, date, tags, aliases, and CSS classes, which keeps notes structured and retrievable.

When should I use wikilinks instead of standard markdown links in Obsidian?

Use wikilinks instead of standard markdown links when establishing intra-vault relationships, because wikilinks ensure that internal links and headings stay robust and navigable during file renames.