editmd

Edit markdown as a rendered page. Save it as plain markdown.

A small native Mac editor. You type in the formatted document, as in a word processor, and editmd writes the file back as markdown.

brew install --cask kirahowe/tap/editmd

View on GitHub Other ways to install

Free and open source (MIT). macOS 14 or later.

editmd showing a markdown file called Garden tracker, rendered as a document: YAML front matter in a box at the top, a heading, a task list with two items ticked, a table of moisture readings, a Mermaid flowchart from probe to board to hub to a shared log, a JSON code block and a block quote.
One markdown file, rendered and editable. Front matter, task list, table, Mermaid diagram and code block are all plain markdown on disk.

Features

Works alongside coding agents

Other programs can edit the file while it is open, a coding agent for example. editmd merges their changes into the window and shows you who changed what.

  • Each agent's changes are highlighted in its own color: added text is tinted, new blocks get a bar in the margin, and a marker shows where text was deleted.
  • editmd names the agent working in the file's folder, such as "Claude ยท website". Double-click a name to rename it.
  • A legend lists each agent and its changes. Click a name to jump to its next change, clear its highlights, or minimize the legend.
  • With unsaved edits, both sides' changes are kept. Edits to different paragraphs, list items or table rows combine, and your cursor stays where it was.
  • Highlights stay with the agent's text while you type, and Cmd-Z undoes only your own edits.
  • Before writing, a save reads the file one last time and merges anything newer on disk.

Each window keeps the document in a Yjs CRDT and replays outside changes as edits against it, block by block. To tell apart agents that share a folder, have their tool hooks run editmd --report-edit, as the README shows.

The editor page with two agents working in it. Their edits arrive as changes to the file on disk.

Safe to open someone else's README

Install

With Homebrew

brew install --cask kirahowe/tap/editmd

From source

You need Xcode (or the Swift toolchain) and bun. make install builds the app, copies it to ~/Applications and registers it.

git clone https://github.com/kirahowe/editmd
cd editmd
make install

Then open a file

open -a editmd notes.md

Requires macOS 14 or later.