Conversion modes

The mode parameter controls the balance between speed and fidelity.

fast

Recommended default for most documents and AI-agent pipelines.

Better structure for irregular layouts, tables and mixed document content.

Slower best-effort mode for difficult documents where structure matters more than speed.

Starts fast and uses a stronger path only when the first result is too lean.

Document	Suggested mode
Regular PDFs, reports and contracts	`fast`
Tables or irregular layout	`balanced`
Difficult document failing in other modes	`quality`
You do not know what to expect	`auto`

For CSV, TXT, DOCX, XLSX, PPTX and HTML, mode usually has little effect. Each format follows the best available conversion path for that file type.

Regardless of mode, clean=true by default normalizes Markdown, collapses excess line breaks, removes control lines and reduces repeated headers.