Docs

mdworker is an HTTP API that turns documents into Markdown. Send a file to POST /v1/convert with an API key and get Markdown back: headings, lists, tables and links come from the file itself, and an OCR model reads scans and pictures. You pay credits for the pages converted and nothing when a conversion fails.

• Base URL: https://api.md.tlelabs.com
• Formats: PDF, DOCX, PPTX, XLSX, HTML, detected from the file’s bytes.
• Price: 1 credit per page read from the file, 3 credits per OCR page with ocr_model=auto.
• Files up to 50 MB. Service health: status.md.tlelabs.com.

Start here

• Quickstart: create a key and convert your first file.
• Authentication: API keys, rotation and the one 401.

API reference

• Convert a file: POST /v1/convert, its options and both response types.
• Quote before converting: POST /v1/quote, the price of up to 10 files without converting them.
• Wallet: GET /v1/wallet and GET /v1/wallet/transactions.
• Health and status: GET /v1/health and the public status page.

Concepts

• OCR models: ocr_model, the auto chains and the price of each model.
• Formats, pages and pricing: what is extracted, how pages are counted, limits.
• Errors: the error format and every error code.
• Rate limits: concurrent conversions and retries.

These pages are also available as Markdown for tools and language models: add .md to a page URL (for example /docs/convert.md), or read /llms.txt and /llms-full.txt.