# A Markdown editor built for working with agents

> A GitHub-flavored Markdown editor with a live preview and Mermaid diagrams, where the AI assistant, Claude Code, Codex or any MCP client edits the same files you do.

Agents read and write Markdown better than any other format, so MCP Docs makes it a first-class document: the text on one side, a GitHub-flavored preview on the other, and your agent editing the same file while you read along.

![A Markdown summary of a paper, its text on the left and the formatted preview on the right](https://mcpdocs.freeflow.im/marketing/markdown.webp)

## What you can do

- **Live preview.** The formatted page beside the text as you type, in GitHub's style, with a panel you can resize or hide.
- **GitHub-flavored Markdown.** Tables, task lists, strikethrough, footnotes, code blocks and links, as GitHub shows them.
- **Mermaid diagrams.** A `mermaid` code block is drawn as its diagram: flowcharts, sequence diagrams, timelines and more.
- **Plain `.md` files.** In the desktop app a Markdown file is the file in your folder, nothing more, so git, your code editor and your agents all see the same text.
- **Scratch pads.** One click makes a new Markdown note for the day, for quick notes and for handing text to an agent.
- **PDFs to Markdown.** Turn any PDF into a Markdown file beside it, then read and edit it here.

## Work on Markdown with your agent

Ask the assistant beside the file in plain words:

- "Summarize this paper as a one-page brief with a table of the results."
- "Add a Mermaid sequence diagram of the login flow."
- "Turn these notes into a README with install and usage sections."

The agent reads the file as numbered blocks and edits the ones it means to, each as an undoable step. Because a Markdown file in the desktop app is a plain file in your folder, the agents you already use can work on it directly, and over MCP they can show it to you in the app as they go:

```sh
npx @freeflow-im/mcp-docs
```

## Frequently asked questions

### Is the file still plain Markdown?

Yes. MCP Docs saves the text exactly as it is, with no extra formatting added. Open it in any other editor and it reads the same.

### Does it show the file when another program changes it?

Yes. In the desktop app an open file reloads when another program or an agent changes it on disk, as long as you have no unsaved changes of your own.

### Can I turn a Markdown file into a PDF?

Yes. Download any Markdown file as a PDF, laid out as its preview is.

### Is it free?

Yes. MCP Docs is free and open source, for Macs with Apple silicon and 64-bit Windows, and in beta on the web.

## Get MCP Docs

- Download the desktop app for macOS or Windows: https://github.com/freeflow-im/mcp-docs/releases/latest
- Install it and add it to Claude Code and Codex: `npx @freeflow-im/mcp-docs`
- The web version (beta): https://mcpdocs.freeflow.im/register
- How an agent connects to MCP Docs: https://mcpdocs.freeflow.im/llms.txt

## Other features

- [Edit PowerPoint presentations with your AI agent](https://mcpdocs.freeflow.im/features/presentations.md): Open, edit and save PowerPoint (.pptx) presentations with an AI assistant beside them, or let Claude Code, Codex or any MCP client build and edit the slides while you watch.
- [Excel spreadsheets your AI agent can work in](https://mcpdocs.freeflow.im/features/spreadsheets.md): Edit Excel (.xlsx) and CSV files with formulas, filters, charts and formatting, and let an AI assistant, Claude Code, Codex or any MCP client sort, clean up and fill in the data.
- [Word documents you write with your AI agent](https://mcpdocs.freeflow.im/features/documents.md): Write and edit Word (.docx) documents with headings, pictures and video, and let the built-in AI assistant, Claude Code, Codex or any MCP client draft and edit them with you.
- [PDFs your AI agents can read](https://mcpdocs.freeflow.im/features/pdfs.md): Read and sign PDFs, and turn any PDF, scanned pages included, into Markdown that Claude Code, Codex and other AI agents can read and edit, with the free MCP Docs app.
- [An image editor you can ask](https://mcpdocs.freeflow.im/features/images.md): Crop, resize, adjust colors, add text and shapes and stack layers on your pictures, or ask the AI assistant to do it, background removal included, in the free MCP Docs app.
- [Office files for your AI agents, over MCP](https://mcpdocs.freeflow.im/features/ai-agents.md): Give Claude Code, Codex, Cursor or any MCP client the tools to open, read, create and edit Word, Excel and PowerPoint files, PDFs, Markdown and pictures, and watch each change in the MCP Docs app.