Overview
REST API to convert PDF, DOCX, images, and 20+ formats to Markdown programmatically. Sync and async with webhooks.
The Markdown Anything API lets you convert 20+ file formats to clean Markdown via a simple REST interface. All requests are authenticated with Bearer tokens and scoped to a workspace.
Base URL
https://markdownanything.com/api/v1Quick Reference
| Method | Endpoint | Description |
|---|---|---|
POST | /convert | Convert a file to Markdown (sync or async) |
GET | /conversions/{id} | Get conversion status and result |
Authentication
All requests require a Bearer token in the Authorization header. Tokens are prefixed with mda_ and scoped to a single workspace.
curl -H "Authorization: Bearer mda_your_token_here" \
https://markdownanything.com/api/v1/convertSee Authentication for setup instructions.
Response Format
All responses are JSON. Successful conversions return a 200 status for sync requests or 202 for async. Errors return standard HTTP status codes with a consistent error object.
{
"error": "error_code",
"message": "Human-readable description."
}See Errors for the full error reference.
Sections
Authentication
Generate API tokens, configure Bearer auth, and understand workspace scoping.
Convert Files
POST /convert — sync and async modes, parameters, and code examples.
Conversions
GET /conversions/{id} — poll for status and retrieve results.
Webhooks
Async delivery, HMAC signing, retry policy, and verification examples.
Rate Limits
Per-plan rate limits and 429 handling.
Errors
Error codes, response format, and auto-refund behavior.