{"slug": "markdown-editors-weren-t-built-for-coding-agents-so-i-made-one", "title": "Markdown Editors Weren't Built for Coding Agents, So I Made One", "summary": "Engineer and developer Takaaki Umada created Marginal, a markdown editor designed for coding agents like Claude Code, after finding existing editors inadequate for managing agent-generated documents, skills, and rules. The tool automatically discovers a coding agent's effective skills, rules, and commands, supports subdirectory file listing, offers AI-assisted editing with inline diffs, and includes Emacs/Vim modes. Marginal is available for macOS, with a free version and a paid Pro tier at $30.", "body_md": "Blog\n\n# Markdown Editors Weren't Built for Coding Agents, So I Made One\n\nLike many engineers, I use coding agents heavily every day, mainly Claude Code. They are amazing tools for expanding what an engineer can do. I can no longer imagine doing my development work without them.\n\nThese days I have coding agents write dev plans, run security audits, generate BDD test cases, and more. For each plan and audit, I have the agent write down the plan or the audit results in markdown. On top of that, I periodically maintain `CLAUDE.md`\n\nand try out other engineers' amazing skills. As a result, I now have an overwhelming number of markdown documents, sometimes more than 100, scattered across different subdirectories.\n\nWorse, I've completely lost track of which skills are currently available, which sub-agents are installed, and which rules are in effect. Some are project-local; some are shared across my account on a specific machine. I also occasionally try other coding agents like Codex and OpenCode, and each of them searches different paths.\n\nEditing `SKILL.md`\n\nfiles brings another problem: they use a special markdown format with YAML front matter containing mandatory fields such as `name`\n\nand `description`\n\n. I want an editor that understands this structure and highlights it properly.\n\nSo I went looking for a markdown editor that understands coding-agent culture, one that can find the currently effective skills, rules, and commands for whichever coding agent I'm using.\n\nUnfortunately, I couldn't find anything that met these requirements. Today's markdown editors work perfectly for note-taking or getting things done, but not for coding agents.\n\nSo I decided to build one. Here are the features I've implemented. I hope you like them too.\n\n## 1.Automatic discovery of your coding agent's skills, rules, and commands\n\nOf course, this is the number one feature I needed. Based on the selected coding agent (Claude Code by default), Marginal automatically finds the currently effective `CLAUDE.md`\n\nor `AGENTS.md`\n\n, along with the skills, rules, sub-agents, and commands, and lists them in the sidebar. You no longer lose track of which ones are in effect for the current project.\n\n## 2.Finding markdown files in subdirectories\n\nThis is an opt-in feature, but if you have a lot of markdown files under subdirectories, you will probably want it. Turn on \"List files in subfolders\" in Settings, and the list shows every markdown file under the selected directory.\n\nIn the filter box at the top of the list, you can type part of a file's path, including `/`\n\nto match a directory, to narrow down the file you need. Go to File (⌘T) does the same thing to open a file directly.\n\n## 3.Two AI interfaces\n\nThe first one is inside the editor. Select some text, press ⌘K, and tell the AI what to do with it. The rewrite streams in as an inline diff, and you accept or reject it as a single undo step. It runs on your own API key, and you pick the provider and model in Settings: Anthropic, OpenAI, Google, xAI, or Alibaba Cloud.\n\nThe second one is the coding agent in the terminal, as usual. ⌘J opens a terminal panel below the editor, so you can run `claude`\n\nor `codex`\n\nright there. When the agent writes to a file you have open, Marginal notices and offers to reload it, and a new skill it saves appears in the SKILLS section without reopening the folder.\n\n## 4.Read & export\n\nDouble-click a markdown file in the Finder and Marginal opens it in reading mode, which shows only the preview pane so you can focus on reading. From there you can export the file directly as PDF or HTML. Press Esc to return to the normal editing mode.\n\n## 5.Emacs/Vim editing modes with custom key mapping\n\nThe editing mode can be set to Default, Emacs, or Vim, and the status bar shows which one is on. Yes, I'm an Emacs guy, so I need `Ctrl-S` \"readme\" `Ctrl-S` `Ctrl-S` `Ctrl-G` to land on the third occurrence of \"readme\". Vim users get `/`\n\n, `?`\n\n, `n`\n\n, and `N`\n\nthe way they expect, with the Vim mode shown in the status bar as well.\n\n## 6.Dark mode and themes, including your own\n\nLike any modern application, Marginal supports dark mode. Ten themes are built in, in five light/dark pairs: Marginal, GitHub, Solarized, Zenburn, and Dracula. A theme is a single JSON file, so you can install your own custom theme, and Marginal loads it on the fly without a restart.\n\n## One last thing\n\nMarginal was built the way it is meant to be used: with Claude Code, plan files, rules, and skills in the repository, edited in Marginal itself once it could open them. It runs on macOS, Windows, and Linux, and you can download it from [marginal.md](download.html). The manual is at [marginal.md/docs](docs/). Editing needs a subscription after the trial; the AI features run on your own API key and are never gated. If your coding agent keeps its files somewhere Marginal doesn't look yet, tell me, and it becomes a row in a table.\n\nMarginal is $10 a month or $96 a year, with a 14-day trial and no card. [Pricing](pricing.html) · [Download](download.html)", "url": "https://wpnews.pro/news/markdown-editors-weren-t-built-for-coding-agents-so-i-made-one", "canonical_source": "https://marginal.md/blog.html", "published_at": "2026-09-03 06:45:56+00:00", "updated_at": "2026-09-03 06:52:00.231415+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools", "ai-agents"], "entities": ["Takaaki Umada", "Marginal", "Claude Code", "Codex", "OpenCode", "Anthropic", "OpenAI", "Google"], "alternates": {"html": "https://wpnews.pro/news/markdown-editors-weren-t-built-for-coding-agents-so-i-made-one", "markdown": "https://wpnews.pro/news/markdown-editors-weren-t-built-for-coding-agents-so-i-made-one.md", "text": "https://wpnews.pro/news/markdown-editors-weren-t-built-for-coding-agents-so-i-made-one.txt", "jsonld": "https://wpnews.pro/news/markdown-editors-weren-t-built-for-coding-agents-so-i-made-one.jsonld"}}