Office & Data COMMUNITY New

Obsidian Markdown

You let Claude create and edit notes for Obsidian, using wikilinks, embeds, callouts, tags and frontmatter properties in valid syntax.

Level ● Beginner
Saves looking up Obsidian syntax and fixing badly formatted notes
Updated 2026-11-02
Available in: claude-codecoworkclaude-desktop

What is Obsidian Markdown?

Obsidian Markdown is a skill for Claude that teaches it the syntax of Obsidian Flavored Markdown. Obsidian adds its own elements on top of CommonMark and GFM: wikilinks between notes, embeds marked with an exclamation point, callouts, frontmatter properties, hidden comments and highlights. The skill focuses on these additions only. Regular Markdown such as headings, lists or tables is treated as something Claude already knows.

When creating a note, Claude follows a fixed sequence. It starts with frontmatter holding properties like title, tags and aliases. Then comes the content, with wikilinks pointing to notes inside your vault and plain Markdown links for outside addresses. Next, Claude embeds notes, images or single PDF pages and adds callouts for key information. Finally, you check the layout in Obsidian's reading view. Extra reference files cover property types, every callout type with its aliases, and audio, search and Bases embeds.

The skill pays off if you keep project notes, documentation or a knowledge base in Obsidian and let Claude write there. It also handles LaTeX math, Mermaid diagrams and footnotes. You need Obsidian to view the results. You install the skill with 'npx skills add kepano/obsidian-skills --skill obsidian-markdown', and it is released under the MIT license.

Who it is for

For anyone who maintains notes, project documentation or a knowledge base in Obsidian and uses Claude to write or reformat those notes.

Use cases

  • After a meeting, you have Claude create a minutes note with a date, tags and links to the matching project note in your vault.
  • You are building a team knowledge base and want Claude to format every note the same way, with properties, aliases and warning callouts.
  • You move existing Markdown documentation into Obsidian and have Claude turn internal links into wikilinks and insert images as embeds.

What Obsidian Markdown does

Wikilinks and block references

Claude links notes, headings and single paragraphs through wikilinks and assigns block IDs for them. For lists and quotes, the ID goes on its own line after the block.

Embeds

With a leading exclamation point, Claude pulls whole notes, single sections, images with a set width, specific PDF pages, audio files, Bases views and search results straight into a note.

Callouts

Highlight boxes such as note, tip, warning or todo, optionally with a custom title, collapsed or expanded, and nested. You can define your own callout types with CSS.

Frontmatter properties

Claude writes YAML properties with fitting types: text, number, checkbox, date, date with time, list and links. The default fields tags, aliases and cssclasses are covered as well.

Tags, comments, highlights

Nested tags using a forward slash, comments wrapped in percent signs that stay hidden in reading view, and highlighted text marked with double equals signs.

Math, diagrams, footnotes

LaTeX expressions inline or as a block, Mermaid diagrams whose nodes can point to Obsidian notes, and both regular and inline footnotes.

Say this to activate the skill

"Create an Obsidian note for the project kickoff with tags and aliases.""Link these notes to each other with wikilinks.""Add a collapsed warning callout to my note.""Embed the architecture image and the third PDF page in this note."

Install

npx skills add kepano/obsidian-skills --skill obsidian-markdown

The command installs the original version from the author's repository (Vercel skills CLI, needs Node.js), add -g for all projects. We do not host a copy: updates come straight from the author. Need help with setup? How to install skills →

Figures with source and date

GitHub stars
≈ 50,500
Installs
94,214
On skills.sh since
20 Jan 2026
Last change in the repository
15 Sept 2026
Licence
MIT

As of 2 Nov 2026. Sources: GitHub, skills.sh. The figures change daily; we show the state of our last lookup.

Checked automatically

Revision of the repository, checked on 2 Nov 2026.

  • Automated check on 2026-11-02 (revision 3ccff53): 4 files in the skill folder read by pattern search. It found no hidden characters, no instructions to override rules, no download-and-run and no access to credentials.

Independent checks on skills.sh, as of 2 Nov 2026

Gen Agent Trust Hub Pass
Socket Pass
Snyk Pass

Full results on skills.sh ↗

Good to know

  • The skill explains only the syntax specific to Obsidian. For regular Markdown it relies on what Claude knows anyway.
  • You only see whether a note looks right once you open it in Obsidian. The skill's last workflow step asks you to look at it in reading view.
  • Wikilinks only work for notes inside your vault. For outside addresses the skill uses plain Markdown links.
  • Custom callout types need a matching CSS rule in Obsidian, otherwise they will not show their own color and icon.
  • The check is an automated pattern search, not a security guarantee, and reads the skill folder only. The command always installs the author's current version; later versions have not been reviewed by us.

Frequently asked questions about Obsidian Markdown

What is Obsidian Markdown?

Obsidian Markdown is a skill for Claude that creates and edits notes in Obsidian Flavored Markdown. It covers the elements specific to Obsidian, including wikilinks, embeds, callouts, properties, tags, comments, LaTeX, Mermaid and footnotes.

How do I install Obsidian Markdown?

You install Obsidian Markdown with the command 'npx skills add kepano/obsidian-skills --skill obsidian-markdown'. After that, Claude uses the skill whenever you work with Obsidian notes, wikilinks, callouts or frontmatter.

Is Obsidian Markdown free?

Obsidian Markdown is released under the MIT license and is free to use. Your use of Claude itself follows the terms of your Claude plan.

Who is Obsidian Markdown for?

Obsidian Markdown is for you if you keep notes, documentation or a knowledge base in Obsidian and let Claude write content for it. The skill makes sure links, embeds and properties match Obsidian's syntax.

How does Obsidian Markdown differ from regular Markdown?

Obsidian Markdown deals only with the additions Obsidian makes to CommonMark and GFM, such as wikilinks, embeds, callouts and properties. Regular elements like headings, lists or tables are assumed to be known already.

What data does Obsidian Markdown send?

Obsidian Markdown consists of instruction files written in Markdown and contains no scripts that send data on their own. Claude processes your note content the same way as any other request.

Share this skill

About this skill

Obsidian Markdown comes from kepano and is an open-source project maintained by its author and community.

Author: kepano / github.com. Source: github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown. Licence: MIT.

Curated by Collective Brain, an AI and automation digital agency from Hamburg, together with WhiteFox Automations. More vetted skills in the skills catalog.

Working in Germany, Austria or Switzerland? We help teams roll out Claude, in English or German.

Want this skill tailored to your team?

Obsidian Markdown is a strong starting point. A skill gets really powerful once it knows your workflows, templates and tone of voice. We build custom skills for teams, from analysis to rollout, and connect them to our work in AI consulting.

Request a custom skill →