# marklipi

> PDF → Markdown for agents. Built for text-layer documents — bank statements, ownership records, tables. Fast and cheap because we don't waste a vision model on documents that don't need one.

marklipi is a stateless PDF-to-Markdown conversion API for AI agents. No API key for basic use. Upload a PDF (multipart/form-data, field `file`, max 25 MB) to POST https://api.marklipi.com/convert and get JSON back: `{markdown, filename, characters}`. Rate limits: 10/minute, 100/day per IP. Text-layer PDFs only — no OCR. Higher limits are paid: Founding Supporter ($5 one-time, 1,000/day for life) or Pro ($19 per month, 25,000/day) — email hello@dovey.com.au with the tier name; see https://marklipi.com/docs.md (Pricing section).

## Docs

- [API reference](https://marklipi.com/docs.md): Full API documentation as Markdown — endpoints, errors, rate limits, examples
- [OpenAPI spec](https://api.marklipi.com/openapi.json): OpenAPI 3.1 schema for https://api.marklipi.com
- [Full documentation](https://marklipi.com/llms-full.txt): All documentation in a single file

## Guides

- [How to convert a PDF to Markdown with Python, Node.js, or curl](https://marklipi.com/blog/convert-pdf-to-markdown-python-node-curl.md): Working code examples for the API
- [Markdown vs raw PDF for LLM context: the token math](https://marklipi.com/blog/markdown-vs-pdf-llm-token-costs.md): Why Markdown costs 60–90% fewer tokens
- [PDF text layer vs OCR](https://marklipi.com/blog/pdf-text-layer-vs-ocr.md): How to tell which extraction method a PDF needs
- [Best PDF to Markdown tools compared](https://marklipi.com/best-pdf-to-markdown-tools): Honest comparison of marklipi, Marker, Docling, pymupdf4llm, LlamaParse, unstructured, Jina Reader

## Optional

- [Free in-browser converter](https://marklipi.com/pdf-to-markdown): Drag-and-drop PDF → Markdown for humans, powered by the same API
- [CSV to Markdown table converter](https://marklipi.com/tools/csv-to-markdown-table): Free client-side CSV → Markdown table tool
- [Docs (web)](https://marklipi.com/docs): Human-readable documentation with an agent-mode toggle
- [Blog](https://marklipi.com/blog): Guides on PDF conversion and document pipelines for agents (each post also served as .md)
- [Homepage (Markdown)](https://marklipi.com/index.md): Product overview as Markdown
- [Homepage (web)](https://marklipi.com/): Product overview
- [GitHub](https://github.com/marklipi/marklipi): Source repository