Removes dead weight
Markdown keeps structure: headings, lists, and emphasis, without shipping hidden formatting code into every prompt.
npx easymd-cli auto onOne line: signs you in, then auto-syncs every .md in your repo to your account.
# CLAUDE.md
## Project context
- Stack: Next.js + Clerk
- Agents read this file
## Token rules
Prefer .md over PDF/DOCX
Token economics
Convert messy documents into structured .md once, then reference the same portable file everywhere agents already work.
75–90%
Raw HTML
Strip tags, CSS, nested markup, and rendering noise that models never needed.
40–60%
Word / DOCX
Drop the embedded XML and style runs wrapped around the text. (Image-heavy files shrink less.)
40–65%
PDF vs page images
Send clean extracted text instead of OCR’d page images. Vs already-extracted text, markdown is roughly the same size.
Measured on real documents with the o200k tokenizer. HTML and DOCX figures compare the raw marked-up source to clean markdown; PDF compares page-image/OCR ingestion to extracted text. Actual savings vary by document.
Why it helps
Markdown keeps structure: headings, lists, and emphasis, without shipping hidden formatting code into every prompt.
Stop sending PDFs and Word files through OCR or XML parsing when the useful context fits in plain text.
Humans and agents edit the same source file, so the next prompt references the current truth instead of yesterday’s paste.
Current MCP server capabilities
It runs as a stdio MCP server that Claude, Cursor, or any agent can connect to. It joins the same live Yjs collaboration session as the browser, so agent edits and human edits happen in one shared document.
list_documentsLists every doc in the account with name, title, and last updated time.
read_documentReturns a document by name so the agent reads the latest live content.
create_documentCreates docs that open in live editors and appear in the dashboard.
update_documentReplaces content instantly in the same shared document session.
append_to_documentAppends text to existing content, useful for agent notes and running specs.
npx add-mcp@latest --command easymd --args mcp --name easymdConnect every agent (Cursor, Claude, VS Code…) after `npm i -g easymd-cli && easymd login`.
From your terminal
The MCP server joins the live Yjs collaboration session through stdio, so Claude and Cursor write into the same document as the browser. No separate API. No stale copy. No second source of truth.
$ easymd open CLAUDE.md
File: ./CLAUDE.md
Local: http://localhost:3847
Share this URL with teammates.ready to commit
Sign up, open your dashboard, and invite a teammate. See token-efficient markdown collaboration in under a minute.