Obsidian Markdown
Teaches AI agents how to use Obsidian-flavored Markdown syntax correctly.
Steph Ango (Kepano) is credited as the original ai skill creator. Setup notes, fit assessments, and cautions below are Obsidian Mate editorial guidance. How we review resources
Overview
Created by Steph Ango (Kepano), the `obsidian-markdown` skill gives skills-compatible coding agents a focused reference for editing Obsidian Markdown. It covers wikilinks, block and heading links, embeds, callouts, properties, tags, comments, math, Mermaid diagrams, and footnotes, then asks the agent to verify the result in Obsidian reading view.
Key Features
- Focused Obsidian Markdown reference for skills-compatible agents
- Full coverage of callouts, properties, and wikilinks
- Repository-documented installation paths for Claude Code, Codex, and OpenCode
How to Install Obsidian Markdown
- 1Use the repository's marketplace or npx command when your agent supports that installation path.
- 2For Codex, copy the repository's skills directory into the configured Codex skills path, commonly ~/.codex/skills.
- 3For Claude Code, place the repository contents in a .claude folder at the root of the vault or working directory.
- 4For OpenCode, clone the full repository into the OpenCode skills directory so its nested skill folders remain discoverable.
- 5Restart or open a fresh agent session, then confirm that obsidian-markdown appears in the available skills list.
How to Use Obsidian Markdown
Ask the agent to create or edit a Markdown file inside a test vault. A useful first prompt is: Use the obsidian-markdown skill to create Project Alpha.md with title and tags properties, a link to [[Project Brief]], a warning callout, and an embedded image. Open the note in Obsidian reading view and verify every element before applying the workflow to important notes.
What the Skill Changes
This is an instruction package, not an Obsidian plugin or a connection to your vault. It teaches an agent the syntax and verification sequence to follow when a request involves Obsidian Markdown. The agent still needs filesystem access supplied by its host, and installing the skill does not grant new permissions or start a background service.
End-to-End Test
Begin in a disposable vault. Ask for one note containing properties, a wikilink, a callout, and an embed. Then inspect both source mode and reading view: confirm frontmatter starts on the first line, the link resolves, the callout renders, and the embedded file exists. Only after this check should the agent edit a real vault.
Use the obsidian-markdown skill to create Project Alpha.md. Add title and tags properties, link to [[Project Brief]], include a warning callout, and embed ![[Architecture.png|600]]. Do not invent linked files; report any missing target.Compatibility and Safety
- Agent Skills provide instructions, not enforcement. Review the generated diff before accepting bulk changes.
- Install from the source repository and retain its reference files; copying only an excerpt can omit property, embed, or callout guidance.
- A skills-compatible agent may use a different discovery path. Follow the host's documentation instead of assuming one global folder works everywhere.
- Back up the vault or use version control before asking an agent to rename links or edit many notes.
What does this skill do?
Provides a reusable syntax and workflow reference for agents editing Obsidian-flavored Markdown, including internal links, callouts, embeds, math, and frontmatter properties.
Best for
- Giving AI agents a consistent Obsidian Markdown syntax reference
- Preventing agents from writing standard Markdown when Obsidian syntax is required
- Mastering callout types, math blocks, and internal link aliases
How it works
- Loaded into agent session when working in Obsidian vaults
- Instructs agent on exact rules for wikilinks `[[Note#Heading|Alias]]`
- Defines supported callout types (`[!note]`, `[!warning]`, `[!tip]`, etc.)
- Specifies transclusion syntax `![[Note]]`
License & Attribution
COMMUNITY RESOURCE Author: Steph Ango (Kepano) License: MIT Repository: https://github.com/kepano/obsidian-skills
Details
- Author
- Steph Ango (Kepano)
- License
- MIT
- Type
- Agent Skill
- Compatible with
- Claude Code, Codex, OpenCode, Agent Skills
Frequently Asked Questions
Who maintains this skill?
The skill is published in Steph Ango’s kepano/obsidian-skills repository. This page treats it as an open-source community resource and links directly to that repository for the current source.
Sources and Documentation
This guide was checked against the creator's repository and primary documentation.
Related Obsidian AI Skills
Obsidian Bases
Allows AI agents to manage Obsidian Bases (.base files), formulas, and database views.
JSON Canvas
Allows AI agents to create and edit visual JSON Canvas (.canvas) diagrams.
Obsidian CLI
Teaches AI agents how to interact with Obsidian vaults via command-line interface.
Defuddle
Extract clean, distraction-free Markdown from noisy web pages.
Explore more Obsidian resources
Discover more plugins, themes, templates, and starter vaults to build your perfect Obsidian setup.