v1.0 for macOS · plain Markdown in, plain Markdown out

Your Markdown, finally a workspace.

md-edit opens your project folder and turns READMEs, specs and agent HQ files into Notion-style blocks, live dashboards and ClickUp-style boards. The file on disk stays plain Markdown that your agents, scripts and git already understand.

Download for Mac Try the live demo below

my-project docs/hq.md · Saved

2,075real Markdown files parsed and re-written with zero bytes changed

107self-tests guarding every edit, move and write-back

0third-party dependencies, and no servers, accounts or sync

1 fileis the whole integration for an agent team

```features

One file. Four ways to work with it.

md-edit is a layer on top of your files, not an owner of them. Switch views any time; the Markdown underneath never changes unless you change it.

Blocks you can pick up

Every heading, list, table and code fence is a block with GitHub styling. Drag an H2 and its whole section comes with it. ⌘Z undoes.

A real Markdown editor

Click to edit raw Markdown with BBEdit-style coloring, by block, by nested section, or the whole file at once. Light and dark palettes.

Any doc, as a dashboard

Press ⌥⌘D and sections become cards, checklists get progress bars, and status, board, chat and chart fences become live widgets.

Private notes that never leak

Highlights, header emoji and notes to self live in md-edit's own database, keyed to the file's identity, so they follow renames and moves.

Plays well with everything

Git, Claude Code or another editor changes the file? md-edit reloads. Unsaved edits on both sides? You choose, nothing gets clobbered.

Lossless by design

Open a file and don't edit it: it's never rewritten. Edit one block: only that block changes. CRLF, BOMs and stray whitespace survive.

```board #sprint-12

Markdown as a database.

Boards behave like ClickUp: quick-add tasks, open one to set status, assignee, priority, due date, subtasks and custom fields, switch between Board and List. Every change is one or two lines in the file.

## cola status column - [>]a task record, in progress key: va field: priority, points, anything - [ ]an indented line is a subtask

- [>] Onboarding checklist redesign @sean #design !2026-10-21
  priority: urgent
  points: 8
  - [x] Wireframes
  - [ ] Final copy pass

Onboarding checklist redesign #design Oct 21Urgent1/2 subtasks8SE

```chat #general

The doc is the API.

Point Claude Code, Codex or any agent at one Markdown file. They claim cards, log progress and flag you when they need a human. You watch it all as a live dashboard. The format is compatible with workbench.md, so the same file works there too.

01Drop in the templateCopy the HQ template into your repo as docs/hq.md: status, board, chat and roster, ready to go.

02Paste one promptEach agent gets a name and the house rules: claim a card, log progress, append-only chat, UTC timestamps.

03Watch, steer, decideWhen an agent sets awaiting-human, a banner tells you exactly what it needs. Reply in the chat box.

paste into your agent

You're part of an agent team coordinated through one shared Markdown file: docs/hq.md.
Your name on the team is: builder-2
Claim one unowned card on the ```board, post a one-line claim in ```chat #general,
log progress in ```status, and set state: awaiting-human when you need a person.

Only MarkdownNothing app-specific is ever written into your .md files.

Known by identityFiles are tracked by APFS file ID, so renaming never loses your notes.

Written in placeSaves overwrite the file itself, quietly, a second after you stop typing.

Simple toolingA native Mac app. SwiftPM, system SQLite, no dependencies.

# ready

Open a folder. Everything else is just text.

md-edit 1.0 for macOS 26. [PRICE AND AVAILABILITY]

Download for Mac