# DocumenTo.MD

> Convert documents to clean Markdown via web UI or REST API.

DocumenTo.MD is a document-to-Markdown conversion service. It accepts
PDF, DOCX, XLSX, PPTX, HTML, CSV, RTF, TXT and Markdown files and returns
structured Markdown preserving headings, lists, tables and hierarchy.

## Key facts

- Website: https://documento.md/
- API base URL: https://documento.md/v1
- OpenAPI spec: https://documento.md/v1/openapi.json
- Interactive API reference: https://documento.md/v1/docs
- Developer docs: https://documento.md/developers
- Playground: https://documento.md/playground
- Supported input formats: PDF, DOCX, XLSX, PPTX, HTML, CSV, RTF, TXT, MD
- Output format: Markdown (GitHub-flavored)
- Conversion engine: Microsoft MarkItDown (with stdlib fallback)
- Try without registration: 3 free conversions/day from the homepage (per IP)
- Authentication (API): API Key via `Authorization: Bearer dtmd_live_...` or `X-API-Key`
- Rate limiting: per API Key with `X-RateLimit-*` headers and `429` responses
- Pricing: Free tier (no credit card, 50 conversions/day), Pro and Enterprise
- Privacy: original files are deleted after processing; results have configurable retention

## Primary endpoints

- `POST /v1/convert` — convert a document to Markdown (sync or async)
- `GET /v1/conversions/{id}` — retrieve an async conversion result
- `GET /v1/me` — inspect the current API Key, plan and limits
- `GET /v1/usage` — query API usage statistics

## Quick example

```bash
curl -X POST "https://documento.md/v1/convert" \
  -H "Authorization: Bearer dtmd_live_xxxx" \
  -F "file=@document.pdf" \
  -F "wait=true"
```

Response (200):

```json
{
  "id": "conv_...",
  "status": "completed",
  "format": "pdf",
  "markdown": "# Document title\n\n...",
  "metadata": { "pages": 3, "chars": 4321 }
}
```

## Links

- [Documentation](https://documento.md/developers)
- [API Reference (Swagger)](https://documento.md/v1/docs)
- [Pricing](https://documento.md/#pricing)
- [Try it free without registration](https://documento.md/)
- [Create account](https://documento.md/register)