Convert PDF to Markdown with one API call

Turn a PDF into clean Markdown with a single curl or Python call to the mdkit REST API. No signup needed for small files.

Sync upload cap	8 MB per file (POST /v1/convert)
Anonymous rate limit	30 requests/minute per IP; an API key raises it
Cost	1 credit per sync conversion

A PDF becomes Markdown with one POST /v1/convert call — upload the file as multipart form data and the response body carries the converted text. Anonymous calls work at a low per-IP rate limit, so you can try it before creating a key.

curl

curl -F "file=@report.pdf;type=application/pdf" https://mdkit.online/v1/convert

The response is JSON:

{"markdown": "# Quarterly report\n...", "meta": {"filename": "report.pdf"}}

Python

import httpx

with open("report.pdf", "rb") as fh:
    resp = httpx.post(
        "https://mdkit.online/v1/convert",
        files={"file": ("report.pdf", fh, "application/pdf")},
        headers={"X-API-Key": "YOUR_KEY"},  # optional — raises the rate limit
    )
resp.raise_for_status()
print(resp.json()["markdown"])

Files over 8 MB — or scanned, layout-heavy PDFs that deserve the high-fidelity engine — belong on the async lane: see the async jobs guide.

Try it

Try it free — or paste HTML straight into the free HTML→Markdown tool, no signup.