# obsidian-markdown

This skill helps Claude Code create and edit Markdown notes using Obsidian syntax. Use it for wiki-style links, callouts, embeds, and note properties.

- skill · `type=skill` · Claude Code · 490 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/document-processing/obsidian-markdown
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/obsidian-markdown

## What it does

The skill guides Claude Code in writing notes that use Obsidian features, including links to other notes, headings, and blocks. It also covers embedded images and PDFs, callout blocks, note properties, and familiar Markdown elements such as lists and tables.

This is a Claude Code skill, not an Obsidian plugin. Obsidian links use forms such as `[[Note name]]`, while a Markdown link to a file with spaces needs `%20` in place of each space. That distinction matters when editing links by hand.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill document-processing/obsidian-markdown
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill obsidian-markdown -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/obsidian-markdown/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/obsidian-markdown/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/obsidian-markdown/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/obsidian-markdown/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates obsidian-markdown
```

2. **Manually: put the files in place**
- File: `.github/skills/obsidian-markdown/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/document-processing/obsidian-markdown
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/obsidian-markdown/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/document-processing/obsidian-markdown

## When to use it
- link one note to related entries
- add a titled callout to a note
- embed an image or PDF in a note
- link directly to a heading or block

## Example prompts
- Create a note with internal links to the related entries.
- Add a callout block with a title and explanatory text.
- Embed the image in this note and link to a heading in another entry.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

## Other versions with the same name
- [obsidian-markdown · agricidaniel](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-markdown.md) — 545 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md