---
title: "obsidian-notes"
description: "Reads, writes and maintains markdown so it works as an Obsidian vault and still renders on GitHub and in VS Code: a lint for broken and ambiguous links, orphans, duplicate basenames, missing index files and bad frontmatt"
canonical: https://agentpluginsdirectory.com/plugins/obsidian-notes
last-updated: 2026-10-21
---

# obsidian-notes
Reads, writes and maintains markdown so it works as an Obsidian vault and still renders on GitHub and in VS Code: a lint for broken and ambiguous links, orphans, duplicate basenames, missing index files and bad frontmatter; an index (map of content) writer; a wikilink-to-relative-markdown-link converter; one command to set a folder up as a vault; and the official Obsidian CLI when it is enabled. Evergreen: the skill re-researches Obsidian, its CLI and the agent integrations around it on a schedule and carries the evals that prove it works.
- Slug: obsidian-notes
- Publisher: Mark Rogers
- Repository: https://github.com/m4bwav/obsidian-notes
- Manifest: plugin.json
- Version: 0.4.0
- License: MIT
- Category (editorial): other
- Skills: 1 (obsidian-notes)
- MCP servers: 0
- Stars: 0
- Repository created: 2026-09-19
- Repository last pushed: 2026-10-14
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/obsidian-notes
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What obsidian-notes does, in the publisher's words

An Agent Skill that makes AI-written markdown navigable for people in Obsidian and for later agents, while it still renders on GitHub and in VS Code: an index per folder, explicit Related: links, relative markdown links instead of wikilinks, a lint that finds broken, mis-cased and ambiguous links, orphans, duplicate basenames and malformed frontmatter, one command to set a folder up as a vault, and the official Obsidian CLI when it is enabled. Built 2026-09-18 from the research in skills/obsidian-notes/RESEARCH.md.

The rule it enforces, and why: Obsidian resolves Note and [[Note]] identically and can be set to write markdown links; GitHub, VS Code and most agents render only markdown links; and relative links are path-based, so two files with the same name never collide. Wikilinks are the exception, for a vault nobody reads anywhere else.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/m4bwav/obsidian-notes/HEAD/README.md

## Skills

- obsidian-notes: Makes a folder of markdown work as an Obsidian vault that still renders on GitHub and in VS Code: lints for broken, mis-cased or ambiguous links, orphans, duplicate basenames, missing indexes and bad frontmatter (scripts/vault_lint.py), writes missing index (map of content) files, converts wikilink…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.