skill

obsidian-markdown · davila7 — Claude Code skill for Obsidian notes

Q: How do I install obsidian-markdown in Claude Code?

Run `npx claude-code-templates@latest --skill document-processing/obsidian-markdown`.

Q: How do I link to a heading in another note?

Use `[[Note name#Heading]]`. Add `|Display text` inside the brackets when the link should show different text.

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

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --skill document-processing/obsidian-markdown

Open on GitHub

What obsidian-markdown 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.

What it helps with

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 for the agent

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.

How to install obsidian-markdown

1claude-code-templates

npx claude-code-templates@latest --skill document-processing/obsidian-markdown

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill obsidian-markdown -a claude-code

3Manually: put the files in place

~/.claude/skills/obsidian-markdown/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/obsidian-markdown/

Manually: put the files in place

.agents/skills/obsidian-markdown/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/obsidian-markdown/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install davila7/claude-code-templates obsidian-markdown

2Manually: put the files in place

.github/skills/obsidian-markdown/SKILL.md

Platform CLI

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

Manually: put the files in place

.devin/skills/obsidian-markdown/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about obsidian-markdown

How do I install obsidian-markdown in Claude Code?

Run npx claude-code-templates@latest --skill document-processing/obsidian-markdown.

What does obsidian-markdown do?

It helps Claude Code write and edit Markdown notes using Obsidian features such as internal links, embeds, and callout blocks.

How do I link to a heading in another note?

Use [[Note name#Heading]]. Add |Display text inside the brackets when the link should show different text.

Similar skills

All skills for Writing and docs →

obsidian-markdown by other authors comes first.

obsidian-markdown AgriciDaniel This skill explains, drafts and validates Obsidian Flavored Markdown: properties, wikilinks, embeds, callouts, tags, block references, math and Mermaid. CX Codex +1 545installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. 414,180installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. 990,453installs domain-modeling Matt Pocock This skill sharpens project terminology, maintains GLOSSARY.md, and records selected architecture decisions in ADRs. Use it while the domain model is changing. 876,391installs

From the same set495

The whole set →

vercel-deploy-optimize Optimizes a Next.js build and ships it to Vercel, checking configs along the way and wiring up performance monitoring. 506installs nodejs-best-practices This skill guides Node.js framework, async, architecture, and security choices from project context. Use it when planning or reviewing a Node.js codebase. 501installs backend-architect A Claude Code skill that turns the agent into a backend architect: service boundaries, API contracts, resilience, observability. Useful when the design decision comes before the code. 501installs api-patterns This skill guides API style choices and covers response structure, versioning, and pagination. Use it when planning an API. 491installs nextjs-api-tester Inspects Next.js API routes and generates complete test suites. Useful for verifying authentication, payload validation, and errors across App and Pages Router. 479installs statistical-analysis Automates hypothesis testing, assumption verification, and APA-formatted summary drafting. Helpful for researchers processing scientific experimental datasets. 478installs neon-database-architect A subagent for designing Neon schemas, wiring up Drizzle ORM and tuning queries for serverless workloads. 478installs e2e-setup Sets up end-to-end testing in your project, selects a framework like Playwright or Cypress, and prepares CI integration. 477installs