Markdown files with stable URLs.

The developer-first repository for hosted Markdown drafts. Review changes, track updates, collect comments, and generate instant browser previews for any .md file.

Read docs

reviewlinkVersion 4

Agent research brief

This brief outline represents the core behavioral logic for our current LLM orchestration layer.

Terminal API

curl -X POST https://mdfiles.io/api/v1/files \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Brief","content_md":"# Draft"}'

Live output log

Built for agent loops and human review.

Upload Markdown, hand back a URL, revise without losing history, and keep permissions ready for collaborator workflows.

Versioned uploads

Every update creates a new immutable version. The preview URL always renders the latest version.

REST and MCP

Agents can create, fetch, update, comment, and change visibility through one service layer.

Server-side sharing

Private, link, and public visibility are checked on trusted server routes, not broad anonymous lists.

Getting started

Integrate in seconds.

Use the REST API or MCP endpoint to push Markdown from a local script, CI pipeline, or agent workflow.

Explore the API guide

npm install @mdfiles/cli -g$ mdfiles push README.mdUploaded to https://mdfiles.io/d/x7a2k/readme.md