Tooluck logoTooluck
SKILL.md

obsidian-markdown

Agent skill fromkepano/obsidian-skills

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

How to install obsidian-markdown

install obsidian-markdown
# install the obsidian-skills pack with the skills CLI
npx skills add kepano/obsidian-skills

# or add only this skill to Claude Code: copy the folder

skills/obsidian-markdown/

# into

~/.claude/skills/obsidian-markdown/ (all projects)

.claude/skills/obsidian-markdown/ (one project)

skills/obsidian-markdown/SKILL.md

MITFull file
1# Obsidian Flavored Markdown Skill
2
3Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.
4
5## Workflow: Creating an Obsidian Note
6
71. **Add frontmatter** with properties (title, tags, aliases) at the top of the file. See [PROPERTIES.md](references/PROPERTIES.md) for all property types.
82. **Write content** using standard Markdown for structure, plus Obsidian-specific syntax below.
93. **Link related notes** using wikilinks (`[[Note]]`) for internal vault connections, or standard Markdown links for external URLs.
104. **Embed content** from other notes, images, or PDFs using the `![[embed]]` syntax. See [EMBEDS.md](references/EMBEDS.md) for all embed types.
115. **Add callouts** for highlighted information using `> [!type]` syntax. See [CALLOUTS.md](references/CALLOUTS.md) for all callout types.
126. **Verify** the note renders correctly in Obsidian's reading view.
13
14> When choosing between wikilinks and Markdown links: use `[[wikilinks]]` for notes within the vault (Obsidian tracks renames automatically) and `[text](url)` for external URLs only.
15
16## Internal Links (Wikilinks)
17
18```markdown
19[[Note Name]] Link to note
20[[Note Name|Display Text]] Custom display text
21…

Excerpt shown under the repository's MIT license.

More skills in obsidian-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates