# PDF & DOCX to Markdown

Convert PDF, DOCX, PPTX, XLSX, EPUB, HTML and CSV to clean, LLM-ready Markdown, with headings, lists, tables and links kept.

One call turns a document into Markdown: Word headings, lists, tables and links; one section per PowerPoint slide; one table per spreadsheet sheet; PDF text page by page; EPUB chapters in reading order. Made for feeding documents to language models and search indexes. Files are read in memory and never stored. Scanned PDFs without a text layer and files we cannot read are refused and not charged.

- Structure kept per format: Word headings, lists, tables and links; one section per slide; one table per sheet; EPUB chapters in reading order.
- Files are read in memory and never stored.
- Scanned PDFs without a text layer and files we cannot read are refused and not charged.

## Calls

### `POST https://readymadeapi.com/v1/markdown/from-file`

Send a DOCX, PPTX, XLSX, PDF, EPUB, HTML or CSV file by link or as base64 and get its text back as Markdown, with headings, lists, tables and links kept.

- Price: $0.003 per file
- MCP tool: `file_to_markdown_convert`
- Answers in the same call.

Request:

```json
{
  "file_url": "https://readymadeapi.com/samples/report.docx"
}
```

Answer:

```json
{
  "format": "docx",
  "title": "Quarterly report",
  "markdown": "# Quarterly report\n\nSales grew in every region. Returns fell for the third quarter running.\n\n## Highlights\n\n- Revenue up 12% on the year\n- Two new distributors signed\n- Delivery time cut from 9 days to 6\n\n## Sales by region\n\n| Region | Q3 | Q4 |\n| --- | --- | --- |\n| North | 410 | 455 |\n| South | 385 | 430 |\n| East | 290 | 340 |",
  "parts": null,
  "chars": 330,
  "truncated": false
}
```

## Limits

- By link, up to 15 MB; up to 200 PDF pages.
- Up to 2,000,000 characters of Markdown per call (200,000 unless you ask for more); the answer says when it was cut.

## Questions

**Does it OCR scanned PDFs?**

No. A PDF needs a text layer. For scans, use our Document OCR listing.

**How large can a file be?**

Up to 15 MB by link, or 2 MB as base64, and up to 200 PDF pages.

**Are older Office files read?**

.xls is read. Save .doc and .ppt as .docx and .pptx first.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
