PlugWiki

Obsidian Markdown Skill for Claude: Wikilinks, Callouts and Properties

Makes Claude write valid Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, math and diagrams.

Installs
94.2K
on skills.sh
Stars
50.6K
on GitHub
Files
3
besides SKILL.md
Updated
Sep 2026
last repo commit

obsidian-markdown teaches Claude the syntax that Obsidian adds on top of standard Markdown. Claude adds frontmatter properties, links notes with [[wikilinks]], embeds notes, images and PDFs, and uses callouts, tags, comments, math and Mermaid diagrams.

It triggers when you work with .md files in Obsidian or mention wikilinks, callouts, frontmatter or tags. The skill covers only Obsidian's extensions, not standard Markdown. It ends each note by asking Claude to verify it renders in Obsidian's reading view. The folder holds three reference files and no scripts.

Good for

  • Obsidian users who want Claude to write or tidy notes
  • People building a knowledge base or second brain
  • Writers who use callouts, embeds and properties heavily

Install obsidian-markdown

Claude Code

  1. 1

    Copy this prompt.

    Install the obsidian-markdown skill in Claude Code. Run this command:

npx skills add https://github.com/kepano/obsidian-skills

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The repo holds 6 skills: obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, defuddle and knap. The plugin and the README skills CLI command take all of them.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

  1. Workflow: Creating an Obsidian Note
  2. Internal Links (Wikilinks)
  3. Embeds
  4. Callouts
  5. Properties (Frontmatter)
  6. Tags
  7. Comments
  8. Obsidian-Specific Formatting
  9. Math (LaTeX)
  10. Diagrams (Mermaid)
  11. Footnotes
  12. Complete Example
  13. Tasks
  14. Notes
  15. References

Key facts

Author
kepano (kepano/obsidian-skills)
Repository
kepano/obsidian-skills
Installs on skills.sh
94,181 (crawled 2026-11-02)
GitHub stars
50,577 (whole repo)
License
MIT
Last repo commit
2026-09-15
Files in the skill folder
4 files: SKILL.md, CALLOUTS.md, EMBEDS.md and PROPERTIES.md in references/. No scripts.
skills.sh audits
Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Agents the README names
Claude Code, Codex and OpenCode (it says any skills-compatible agent can use them)

What it includes

  • Six steps: frontmatter, content, wikilinks, embeds, callouts, then verify

    Creating an Obsidian note

  • [[wikilinks]] with headings, block IDs and display text

    Internal links

  • Embed notes, sections, images and PDF pages with ![[ ]]

    Embeds

  • > [!type] blocks, with custom titles and foldable variants

    Callouts

  • Frontmatter properties, tags and Obsidian comments

    Properties, tags, comments

  • LaTeX math, Mermaid diagrams and footnotes

    Math, diagrams, footnotes

  • CALLOUTS.md, EMBEDS.md and PROPERTIES.md hold the full lists

    Read · Reference files

From the official docs

Permissions

Low risk

obsidian-markdown guides how Claude writes note syntax. It creates and edits .md files in your vault, so keep the vault in version control or backed up.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • The plugin route installs 6 skills

    The README plugin command adds every skill in the repo, including obsidian-cli and defuddle, not only obsidian-markdown. Take only the one you want if you do not need the rest.

Questions

What does the obsidian-markdown skill do?

It teaches Claude Obsidian Flavored Markdown, so notes use wikilinks, embeds, callouts, properties and tags correctly. It covers only Obsidian's extensions to standard Markdown.

How do I install it?

Use the install box at the top of this page. The README documents a Claude Code plugin marketplace route, the skills CLI, and manual copies for Claude Code, Codex and OpenCode. For manual Claude Code use it says to put the repo contents in a .claude folder at the root of your vault.

Does it need Obsidian running or an API key?

No key is named in SKILL.md. The skill is about writing valid note syntax. Its last workflow step has Claude verify the note renders in Obsidian's reading view.

Are there related Obsidian skills?

Yes. The same repo lists obsidian-bases, json-canvas, obsidian-cli, defuddle and knap. They are separate skills, and SKILL.md does not point to any of them.

Is it safe?

It bundles no scripts. The folder holds SKILL.md and three markdown reference files, and the skill is syntax guidance for notes.

Wikilinks or Markdown links?

SKILL.md says to use [[wikilinks]] for notes inside the vault, since Obsidian tracks renames, and standard [text](url) links for external URLs only.

Information

updated Nov 2, 2026

Repository
kepano/obsidian-skills
Folder
skills/obsidian-markdown

kepano/obsidian-skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2
  1. obsidian-skills README · github.com
  2. obsidian-markdown SKILL.md · github.com

Updated Nov 2, 2026.