OpenMarkdown plugin
The OpenMarkdown plugin for Claude Code opens agent Markdown documents in a local editor and gives shared editing over MCP
- 70 ★ on the repository
- Last commit
Extended access
Why this level
- The MCP server lets the agent open files, read what you selected and edit document sections in the app
- Co-editing mode keeps the agent in a wait loop and answers your markers without separate requests
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/openmarkdownDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The MCP server lets the agent open files, read what you selected and edit document sections in the app
- Co-editing mode keeps the agent in a wait loop and answers your markers without separate requests
This is third-party code. Review the repository files before installing.
What it does
OpenMarkdown is a fast local Markdown editor built for working with an agent, and the Claude Code plugin in the repository's `plugin` folder turns files into a shared whiteboard. The agent opens a file with `open_file`, jumps to a section through `reveal`, learns what you are looking at through `get_context` and calls `execute_command`. The editor ships no model: it runs on the agent you already use. The plugin has four commands. `/openmarkdown:show` lands what was just written in a file and opens it with no save-first dance. `/openmarkdown:co-edit` starts live co-editing of a file and watches your edits, reacting to `@agent` markers. `/openmarkdown:listen` listens on the workspace sidebar: you type there and the agent answers there. `/openmarkdown:status` reports in one line whether the app is reachable and what is being watched. Write-back rules, the wait loop and replies are described in the `using-openmarkdown` skill. The MCP server starts with `openmd mcp`. Inside the app you can start Claude Code, Codex, Gemini CLI or opencode in a terminal tab and the agent answers in the sidebar. Notes stay plain `.md` files on disk with no account, sync or telemetry. The app is free on macOS, Windows and Linux, and co-editing works on macOS and Linux.
Who it is for. Writers of Markdown text, notes and docs who work with Claude Code and want to see the agent result in an editor.
Good fit when
- An agent wrote a spec draft and it should open in the editor at once, with no save-the-file step
- You edit a section of a document while the agent watches changes and answers your `@agent` markers
- You want to ask the agent straight from the workspace sidebar and get the reply there
- The agent needs to know which section you are reading now and jump to the right heading
- One line checks whether the agent sees the app: `/openmarkdown:status`
Not a fit when
- You need backlinks, a graph or an infinite canvas: Obsidian fits better for that
- You work on Windows and want co-editing: it is coming there and the app serves as an ordinary editor
- You need an editor with a built-in model: OpenMarkdown has none
- Your notes live in a cloud service with sync: the app has only local files
Example request
Run /openmarkdown:co-edit for docs/spec.md, open the file in my editor and watch my editsLimitations
- The OpenMarkdown app itself must be installed (macOS, Windows, Linux AppImage), and the plugin only connects an agent to it through `openmd mcp`.
- Co-editing works on macOS and Linux and is coming to Windows; you can run the Linux build under WSL.
- The repository holds only built releases, the README, the site and Issues: the app source is not published.
- GitHub did not detect the repository license, so see the app terms at openmarkdown.dev.
How to disable. Remove the plugin with `/plugin uninstall openmarkdown` and the marketplace with `/plugin marketplace remove openmarkdown`. The app itself is removed the usual way for your system and notes stay as `.md` files on disk.
FAQ
How do I connect the plugin to Claude Code?
Install the OpenMarkdown app, then run `/plugin marketplace add OpenMarkdown-dev/OpenMarkdown-releases` and `/plugin install openmarkdown@openmarkdown`. Check the link with `/openmarkdown:status`.
Does OpenMarkdown have its own model?
No. The editor contains no AI and runs on the agent you already use: Claude Code, Codex, Gemini CLI or opencode.
What does the co-edit command do?
`/openmarkdown:co-edit` opens the file and watches your edits, answering `@agent` markers. It works on macOS and Linux.
Where does the data go?
Notes stay as `.md` files on disk with no account, sync or telemetry. What touches the network is described on the site transparency page.
Which MCP tools does the plugin give?
`open_file`, `reveal`, `get_context` and `execute_command`, plus `wait_for_change` and `post_message` for the sidebar. The server starts with `openmd mcp`.
Discussion
No questions or reviews yet.
Related
PluginsAdeu: an MCP server, skill and CLI for editing .docx through an agent with real Track Changes, comments and version diffs.
A CLI and MCP server for a research paper library: the agent searches, imports and reads papers and keeps Markdown notes in your vault
A LaTeX, Typst and Markdown editor with a local MCP server: an agent reads, edits and compiles the open project
A self-hosted RAG platform: cited answers over GitHub, Notion, Drive and files, with an MCP mode for Claude Code.
The Word to Markdown MCP server: an agent turns a .docx file into clean Markdown locally, with images, tables and footnotes.
An MCP server that turns PDF, DOCX, XLSX, PPTX, images, audio, web pages and YouTube transcripts into Markdown
README in short
The README presents OpenMarkdown as a fast Markdown editor for you and your agent, gives download links for three systems and lists features: live preview, an agent in the sidebar, a command palette and plain files. It then says who it does not fit and links the docs.