obsidian-markdown

by AgriciDaniel 11k MIT Updated Aug 1, 2026
obsidian-markdown skill by AgriciDaniel
obsidian-markdown — Docs skill by AgriciDaniel

obsidian-markdown is an open-source docs skill for Claude Code and compatible agents, published by AgriciDaniel. Its author describes it as: “Explain, draft, or validate Obsidian Flavored Markdown syntax: properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid. Use when the user explicitly requests Obsidian n…”. The project has 11k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add AgriciDaniel/claude-obsidian`.

What obsidian-markdown does

Use this as a compact fallback for Obsidian-specific syntax. Prefer a separately installed `kepano/obsidian-skills` `obsidian-markdown` skill when available, then current Obsidian Help, for detailed or version-sensitive questions.

Installation

Add obsidian-markdown to your agent with:

/plugin marketplace add AgriciDaniel/claude-obsidian

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for obsidian-markdown is organised into these sections:

  • Properties
  • Wikilinks and embeds
  • Callouts
  • Other Obsidian syntax
  • Validate a drafted note

When to use it

Reach for obsidian-markdown when you want docs help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

  • Clear MIT license — safe to read and adapt
  • Ships in AgriciDaniel/claude-obsidian, an established project with 10,998 GitHub stars
  • Actively maintained (recent commits)

Topics

agent-skillsai-note-takingai-second-brainclaude-codeclaude-code-skillclaude-memoryclaude-pluginkarpathy-llm-wikiknowledge-graphknowledge-managementnote-takingnotion-alternativeobsidianobsidian-aiobsidian-pluginobsidian-second-brainopen-sourcepersonal-knowledge-managementpkmsecond-brain

Frequently asked questions

What does obsidian-markdown do?
Explain, draft, or validate Obsidian Flavored Markdown syntax: properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid. Use when the user explicitly requests Obsidian note formatting or syntax help, not for general Markdown or broad vault operations.
How do I install obsidian-markdown?
Run /plugin marketplace add AgriciDaniel/claude-obsidian in your agent, then reload your skills. Review the source at https://github.com/AgriciDaniel/claude-obsidian before installing.
Is obsidian-markdown free to use?
Yes. obsidian-markdown is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
Where does obsidian-markdown come from?
obsidian-markdown ships inside AgriciDaniel/claude-obsidian, a repository that contains 17 catalogued skills in total. The repository's 10,998 GitHub stars apply to that whole collection, not to this skill on its own.

Related skills

More Docs →

Plan and, with explicit network consent, use an optional external Defuddle cleaner to extract article-like HTTPS pages as Markdown. Use for defuddle, clean this URL, strip page clutter, readable Markdown from a web page, or preparing a web source for later wiki ingestion.

11k AgriciDaniel MIT

Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core.

11k AgriciDaniel MIT

Create a bounded, extractive, structurally idempotent rollup of recent Obsidian wiki log entries, with dry-run preview by default and one optional transaction apply. Use for manual log compression without modifying child pages. Triggers: fold the log, run a fold, run wiki-fold, log rollup, roll up log entries, commit the fold.

11k AgriciDaniel MIT

Run a deterministic, read-only health check on an Obsidian wiki. Use for lint, vault health check, audit wiki health, find orphans, find dead links, frontmatter audit, provenance audit, or wiki audit. Reports graph, link, frontmatter, provenance-ledger, empty-section, and stale-index findings; it does not reason broadly or repair files.

11k AgriciDaniel MIT

Answer an explicitly vault-scoped question from an Obsidian wiki without changing it. Use when the user selects the vault as the evidence source: query the wiki, query quick, query deep, explain from the wiki, summarize the vault, find in wiki, search the wiki, or based on the wiki. Do not route ordinary general-knowledge questions here.

11k AgriciDaniel MIT