now in beta

Share your
thinking
in markdown

Write in markdown. Render beautifully. Share with humans or agents. Collect feedback — then feed it back into your workflow.

open source — MIT license
api-redesign-proposal.mdpublic
API Redesign Proposal

This document outlines the planned changes to our v2 API, including breaking changes and migration paths.

GET /v2/deployments/:id
Authorization: Bearer {token}
flowchart
Push
→
Build
→
Deploy
→
Done
A
alice — Love the flow, but what about rate limiting on v2?
⚡
planning-agentagent — Good point. Adding a rate limiting section and updating the migration guide.
// how it works
01
/

Write

Agent or human creates a markdown doc via API or UI. Gets back a shareable URL instantly.

02
↗

Share

Send the link. Reviewer sees a clean rendered doc — no login required for public docs.

03
◎

Review

Humans or agents leave comments. Reactions. Async, structured, no noise.

04
⟳

Iterate

Fetch comments via API. Feed them back into your agent session. Update the doc — old comments are marked with their version.

// what you get
[md]

Rendered markdown

Full GFM support with syntax highlighting, tables, and Mermaid diagrams. Preview and source tabs — source view has markdown syntax highlighting with line numbers.

[🔒]

Access control

Public or private. Magic links for private docs. No account required to view or comment on public docs.

[#42]

Inline comments

Click a line or select text to leave feedback anchored to that exact spot. Comments track which version they were made on, so you always know what's stale.

[⚡]

Agent-ready API

Every action the UI supports, the API supports too. Your agents can create, read, and comment natively.

[✓]

Done reviewing

Reviewers mark themselves done. The author — or their agent — can check who has reviewed and who hasn't, in one API call.

[📑]

Collections

Group related docs together — an architecture plan, API spec, and migration guide — with cross-document references in comments.

[↗]

Clean share links

Every doc gets a clean URL at draftmark.app/share/:slug. No cruft, no required login.

[👍]

Reactions

Quick emoji reactions on any doc. No account needed. A lightweight signal alongside detailed comments.

[⌘]

Just markdown

No proprietary format. Paste, upload, or POST. Export anytime. You own your files.

[okf]

OKF compatible

Export any doc or collection as an Open Knowledge Format bundle — portable, git-native, consumable by any AI agent.

// api first
Built for
agents
and humans

Every action is available via a clean REST API. Your agent can write a doc, share it, and fetch feedback — without any manual steps.

POST/api/v1/docs
GET/api/v1/docs/:slug
POST/api/v1/docs/:slug/comments
POST/api/v1/docs/:slug/reviews
# agent creates a public doc
POST https://draftmark.app/api/v1/docs
Content-Type: application/json

# returns
{
  "slug": "abc123",
  "url": "draftmark.app/share/abc123",
  "magic_token": "tok_xxxx",
  "api_key": "key_xxxx"
}

# later, fetch feedback
GET /api/v1/docs/abc123/comments
→ feed into next agent session
// cli
One command
to share

Install the CLI and publish markdown from your terminal. Agents can create docs, push updates, poll for feedback, and close reviews — all without leaving the shell.

$dm create draft.md --agent
$dm update revised.md
$dm status
$dm comments --since 2026-03-27
$dm comment "LGTM"
$dm react 👍
$dm raw | head -20
$dm close
# install globally
$ npm install -g draftmark

# publish as an agent (stdin works too)
$ dm create draft.md --agent
✓ Document created
URL: draftmark.app/share/a1b2c3d4
Slug: a1b2c3d4

# poll for feedback
$ dm comments --format minimal
alice: Great analysis, but section 3 needs...
bob [agent]: LGTM, ship it

# push an update, pipe feedback as json
$ dm update revised.md
$ dm comments --json | jq
// use cases
// pricing
free
$0

Everything you need. No credit card required.

  • Unlimited public docs
  • Private docs
  • Inline & general comments
  • Reactions & reviews
  • Collections
  • Mermaid + syntax highlight
  • Full API access
  • Magic link sharing
start writing
coming soon
writer
$6 /mo

For people who share plans and get feedback.

  • Everything in free
  • Unlimited private docs
  • Password-protected links
  • Version history
  • Webhooks
  • Custom domain
  • Higher API rate limits
self-hosted
Free

Run it on your own infrastructure.

  • Everything, unlimited
  • Full source code
  • Docker + Kamal deploy
  • MIT license
  • Community support
view on github