obsidian-markdown
An agent skill from the Obsidian team's obsidianmd/obsidian-skills repository that teaches an agent the syntax Obsidian adds beyond standard Markdown, so the notes it writes display as intended.
What the skill teaches
An agent skill from the Obsidian team's obsidianmd/obsidian-skills repository that teaches an agent the syntax Obsidian adds beyond standard Markdown, so the notes it writes display as intended. It covers frontmatter properties such as tags and aliases, wikilinks to notes, headings and blocks, block IDs, embeds of notes, images and PDFs, callouts, comments and related extensions, plus pitfalls such as escaping alias pipes inside tables and the fact that links resolve by file name rather than alias. The agent is asked to check the note in reading view. Separate reference files cover properties, embeds and callouts.
Capabilities
- Write notes in Obsidian Flavored Markdown
- Add frontmatter properties, tags and aliases
- Link notes, headings and blocks with wikilinks
- Embed notes, images and PDFs
- Add callouts to notes
About
- Publisher
- Obsidian
- Tool
- Obsidian
Works with
Install
- Run this to add it to Any client:
npx skills add https://github.com/obsidianmd/obsidian-skills
What's inside
- references/CALLOUTS.md
- references/EMBEDS.md
- references/PROPERTIES.md
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Obsidian | |
| Publisher | Obsidian | source |
| Official status | Officialrepository is in Obsidian's own GitHub organisation (kepano/obsidian-skills redirects there); plugin manifest names Obsidian as author | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Cursor, Codex | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Sep 15, 202651,606 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
More from Obsidian
13 skills
- defuddle (Skill)
- json-canvas (Skill)
- knap (Skill)
- obsidian-bases (Skill)
- obsidian-cli (Skill)
- obsidian-headless (Skill)
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/skills/kepano-obsidian-markdown/)
Sources
- GitHub repositorygithub.com/obsidianmd/obsidian-skills · Backs: AI clientsNov 12, 2026
- Skill file (SKILL.md)github.com/obsidianmd/obsidian-skillsNov 12, 2026
- GitHub repositorygithub.com/obsidianmd/obsidian-skills · Backs: Official statusNov 12, 2026
- Licence file (LICENSE)github.com/obsidianmd/obsidian-skills · Backs: LicenceNov 12, 2026
- Web pageraw.githubusercontent.com · Backs: PublisherNov 12, 2026
- Folder in the repository (obsidian-markdown)github.com/obsidianmd/obsidian-skills · Backs: Includes scriptsNov 12, 2026
- Skill file (SKILL.md)github.com/kepano/obsidian-skillsNov 14, 2026
- Folder in the repository (obsidian-markdown)github.com/kepano/obsidian-skills · Backs: Includes scriptsNov 14, 2026
- GitHub repositorygithub.com/kepano/obsidian-skills · Backs: Activity, LicenceNov 11, 2026