obsidian-markdown

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

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/gtbauke/bj-utils --skill obsidian-markdown-gtbauke
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-markdown
Source: https://github.com/gtbauke/bj-utils/tree/main/.agent/skills/obsidian-markdown
Command: npx skills add https://github.com/gtbauke/bj-utils --skill obsidian-markdown-gtbauke

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing notes for Obsidian requires knowledge of its extended Markdown syntax—wikilinks, embeds, callouts, properties, and comments—that goes beyond standard Markdown. This Skill ensures every note you create or edit uses valid Obsidian Flavored Markdown that renders correctly in the app. ## Core Features & Use Cases - Wikilinks & Embeds: Create internal links with [[Note]], heading and block references, and embed notes, images, PDFs, and audio with ![[embed]] syntax. - Callouts & Properties: Add foldable callouts with > [!type] syntax and structured YAML frontmatter properties like tags, aliases, and cssclasses. - Extended Syntax: Use Obsidian-specific features including comments, highlights, LaTeX math, Mermaid diagrams, footnotes, and nested tags. - Use Case: When drafting a project note in your Obsidian vault, use this Skill to add proper frontmatter, link to related meeting notes, embed an architecture diagram, and highlight key deadlines in a callout—all with correct syntax. ## Quick Start Create an Obsidian note about my project with frontmatter tags, a warning callout for the deadline, and a wikilink to my meeting notes.

Frequently Asked Questions about obsidian-markdown

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

FAQPage Schema
How do I create internal links in Obsidian notes?▼

Use wikilink syntax with double brackets, such as [[Note Name]], to link between notes in your vault. You can add custom display text with [[Note Name|Display Text]], link to headings with [[Note#Heading]], or reference specific blocks with [[Note#^block-id]].

How do I embed images or other notes in Obsidian?▼

Prefix any wikilink with an exclamation mark to embed content inline, such as ![[Note Name]] for notes or ![[image.png]] for images. You can control image size with ![[image.png|300]] and embed specific PDF pages with ![[document.pdf#page=3]].

What callout types does Obsidian support?▼

Obsidian supports callout types including note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, and todo, each with aliases and distinct colors. Callouts use the syntax > [!type] and can be made foldable by appending - or + after the type.

When should I use wikilinks versus Markdown links in Obsidian?▼

Use [[wikilinks]] for notes within your vault because Obsidian automatically tracks renames and updates links. Reserve standard [text](url) Markdown links for external URLs only, since wikilinks do not work for web addresses.

What characters are allowed in Obsidian tags?▼

Obsidian tags can contain letters in any language, numbers (not as the first character), underscores, hyphens, and forward slashes for nesting like #nested/tag. Tags can be written inline in the note body or listed in frontmatter under the tags property.