# markdown.page

Publish markdown and get a permanent URL. No account or API key required.

## Quick publish

curl https://markdown.page/api/publish --data-binary @README.md

## MCP

POST https://markdown.page/mcp
Tool: publish_markdown({ markdown })

## Response formats

- Browsers receive rendered HTML.
- CLI clients such as curl, wget, and httpie receive text/plain by default.
- Use Accept: application/json for JSON.
- Use Accept: text/plain or Accept: text/markdown for plaintext/markdown.

## Important routes

- API docs: https://markdown.page/api
- LLM guide: https://markdown.page/llms.txt
- MCP endpoint: https://markdown.page/mcp
- FAQ: https://markdown.page/faq
- Examples: https://markdown.page/examples
- Featured articles: https://markdown.page/featured

## Publishing API

POST https://markdown.page/api/publish
POST https://markdown.page/api

Accepted bodies:

- raw markdown
- JSON string
- JSON object with markdown/content/text/body
- form field markdown/content/text/body

Limits and safety:

- 1 MB markdown per page
- public pages are permanent
- do not publish secrets or private data

## Machine-readable docs

curl -H 'Accept: application/json' https://markdown.page/api
curl -H 'Accept: text/plain' https://markdown.page/api