obsidian-markdown: a Claude Code skill by Steph Ango
For Obsidian users who want Claude to write notes with valid wikilinks, embeds and callouts. Skip it if your notes live in tools that ignore Obsidian syntax.
- Score
- 75of 100
- Rank
- #117of 239
- Installs
- 95.9Kon skills.sh
- Security
- Clear 5 scanners
- Updated
- 2026
- Context
- ~69tokens always
Install
npx skills add https://github.com/kepano/obsidian-skills --skill obsidian-markdown
Run it in your terminal. View the source
Using the Claude app rather than Claude Code? You can add a skill there too. How to add it in the app
What does obsidian-markdown do?
obsidian-markdown is a Claude skill that writes notes in Obsidian Flavored Markdown. Its workflow is five steps and a check: add frontmatter properties such as tags and aliases, write the body, link notes with [[wikilinks]], embed notes, images or PDF pages with ![[...]], add > [!type] callouts, then confirm the note renders in reading view. It shows heading and block links with ^block-id, foldable callouts, nested tags, %% hidden comments, ==highlights==, LaTeX math, Mermaid diagrams and footnotes. It keeps wikilinks for vault notes and plain Markdown links for outside URLs. Separate reference files cover properties, embeds and callouts.
When should you use obsidian-markdown?
Use it when
- You want Claude to draft notes for your vault
- You need callouts, embeds or block links right
- You are turning plain Markdown into Obsidian notes
Skip it when
- You don't use Obsidian
- You need Obsidian Bases or Canvas files
What it needs and what it can touch
You need
- An Obsidian vault
What it can do
- Reads and edits Markdown files
From reading its instructions, not from running it.
Why it scores 75
Strongest on quality (100 of 100), weakest on adoption (65).
Is obsidian-markdown safe to install?
Every scanner that checked it passed it. Scanners often miss what other scanners catch, and a skill can change after a scan. Read its source before you install it.
| Scanner | Result | Date |
|---|---|---|
| Gen Agent Trust Hub | Passed | Nov 11, 2026 |
| Socket | Passed | Nov 11, 2026 |
| Snyk | Low risk | Nov 11, 2026 |
| Runlayer | Passed | Feb 28, 2026 |
| ZeroLeaks | Passed | Apr 16, 2026 |
Details
- Installs
- 95,895
- Repository stars
- 51,597
- Last repository change
- Tokens always loaded
- about 69
- Tokens when used
- about 1,264
- License
- MIT
- Data confidence
- High
Did it do the job for you?
Alternatives to obsidian-markdown
All skills for this job-
Get claude-obsidianclaude-obsidian
For Obsidian users who want Claude to file sources into a linked Markdown wiki.
-
Get obsidian-cli
obsidian-cli
For Obsidian users who want Claude to read, write and search notes in an open vault.
-
Get obsidian-bases
obsidian-bases
For Obsidian users who want Claude to write .base files that show notes as tables, cards or maps.
obsidian-markdown