API Overview

The API exposes three ways to convert a document to Markdown, plus a state endpoint. Everything answers text/markdown by default, or JSON if you order it.

Base URL

https://api.markpdf.tech

Authentication

All calls use x-api-key. See Authentication.

x-api-key: YOUR_API_KEY

Endpoints

POST /convert

Upload the file as multipart/form-data.

POST /convert/raw

Send the raw binary in the body. Supports gzip and zstd.

POST /convert/from-url

Convert from a signed URL from S3, R2, Supabase, GCS, or Azure.

GET /jobs/{id}

Status of an automatically queued conversion (202).

GET /

Service status and supported formats.

Parameters

Complete reference of query params, modes and formats.

Answer

Observability headers and body JSON.

The three conversion routes

Endpoint	How do you send the document	When to use it
`POST /convert`	`multipart/form-data` (field `file`)	Web forms, clients that already upload files.
`POST /convert/raw`	Binary in the bodysuit	Maximum efficiency, supports gzip/zstd compression.
`POST /convert/from-url`	URL signed	Large documents already in storage; avoid forwarding bytes.

For large documents, from-url usually wins: your server doesn’t receive or forward the same file twice.

Response model

By default you receive raw Markdown (text/markdown; charset=utf-8) plus observability headers. With response_format=json you receive an object with Markdown and metadata embedded. See Response and headers.

Status codes

Code	Meaning
`200`	Correct conversion.
`202`	Automatically queued (saturated backends). Pulley `/jobs/{id}`. See Jobs.
`304`	Not modified (matches `ETag` sent in `If-None-Match`).
`400`	Invavalid body or malformed URL.
`403`	Unauthorized access or URL host not allowed.
`413`	Exceeds the maximum size, number of pages, or limits of ZIP.
`415`	Format or `Content-Encoding` not supported.
`422`	`url` is missing from `from-url`.
`500`	Internal conversion error.

Detail in Errors.

​API Overview

​Base URL

​Authentication

​Endpoints

POST /convert

POST /convert/raw

POST /convert/from-url

GET /jobs/{id}

GET /

Parameters

Answer

​The three conversion routes

​Response model

​Status codes

API Overview

Base URL

Authentication

Endpoints

The three conversion routes

Response model

Status codes