Obsidian Flavored Markdown Authoring

What it does

Works with Obsidian's extended syntax to structure notes: internal links (wikilinks), block references, callouts, frontmatter properties, and embeds. Keeps notes navigable inside a knowledge vault.

When to use it

• Documenting internal processes in an Obsidian vault
• Building an interconnected knowledge base for a team
• Migrating notes from standard Markdown to Obsidian format

Steps

1. Define the folder structure and note properties
2. Use wikilinks to connect related notes
3. Add callouts to highlight key information
4. Insert block references when citing specific content
5. Fill in frontmatter with the required properties
6. Check that internal links aren't broken

The skill

---
name: obsidian-markdown-authoring
description: Create and edit notes with Obsidian-specific syntax: wikilinks, embeds, callouts, and properties beyond standard Markdown.
---

# Obsidian Flavored Markdown Authoring

## 1. What it does
Works with Obsidian's extended syntax to structure notes: internal links (wikilinks), block references, callouts, frontmatter properties, and embeds. Keeps notes navigable inside a knowledge vault.

## 2. When to use it
- Documenting internal processes in an Obsidian vault
- Building an interconnected knowledge base for a team
- Migrating notes from standard Markdown to Obsidian format

## 3. Steps
1. Define the folder structure and note properties
2. Use wikilinks to connect related notes
3. Add callouts to highlight key information
4. Insert block references when citing specific content
5. Fill in frontmatter with the required properties
6. Check that internal links aren't broken

## 4. Safety rules
Always work in draft mode: nothing is sent, published, or paid for without explicit client approval. Never invent data, metrics, or results. No passwords, tokens, or API keys are requested or shown in chat.

## 5. Deliverable
A clear, reviewable draft of the output (text, code, report, or file), ready for the user to approve before it becomes final.

For Claude Code, save it as ~/.claude/skills/obsidian-markdown-authoring/SKILL.md. In Cursor, ChatGPT or another assistant, paste it as project instructions.