Available Output Formats in Mathpix Python SDK
The Mathpix Python SDK allows you to convert input from images, PDFs, or Mathpix Markdown (MMD) into a wide range of output formats and download them locally.
Supported Output Formats
Format | Description | Supported endpoints |
---|---|---|
Vector PDF of the rendered content | /v3/pdf , /v3/converter |
|
latex_pdf | PDF rendered from LaTeX instead of MMD | /v3/pdf , /v3/converter |
docx | Microsoft Word file with styled math & text | /v3/pdf , /v3/converter |
md | Plain UTF-8 Markdown | /v3/pdf , /v3/converter |
mmd | Mathpix Markdown (source format with LaTeX) | /v3/text , /v3/pdf |
html | Self-contained HTML document | /v3/pdf , /v3/converter |
tex_zip | Zipped folder with LaTeX sources & images | /v3/pdf , /v3/converter |
json | Line-by-line OCR output as structured JSON | /v3/text , /v3/pdf |
mmd_json | Line-by-line JSON (content in MMD) | /v3/pdf |
The
to_*
and to_*_file()
helpers in the SDK automatically pick the correct endpoint based on your request.
Which inputs can you send to each endpoint?
Endpoint | Purpose | Supported Input Types |
---|---|---|
/v3/text |
OCR for images and small documents | JPEG (.jpeg , .jpg , .jpe ), PNG (.png ), BMP (.bmp , .dib ), JPEG 2000 (.jp2 ), WebP (.webp ), Portable image formats (.pbm , .pgm , .ppm , .pxm , .pnm ), PFM (.pfm ), Sun Raster (.sr , .ras ), TIFF (.tiff , .tif ), OpenEXR (.exr ), Radiance HDR (.hdr , .pic ), GDAL-compatible raster/vector formats |
/v3/pdf |
OCR and conversion for documents | PDF, EPUB, DOCX, PPTX, AZW/AZW3/KFX (Kindle), MOBI, DJVU, DOC, WPD (WordPerfect), ODT (OpenDocument Text) |
/v3/converter |
Convert Mathpix Markdown to other formats | MMD string |
Code Example
from mpxpy.mathpix_client import MathpixClient
client = MathpixClient(
app_id="your-app-id",
app_key="your-app-key"
)
# Convert MMD to PDF and Markdown
conversion = client.conversion_new(
mmd="E = mc^2",
convert_to_pdf=True,
convert_to_md=True
)
# Wait until the conversion finishes
conversion.wait_until_complete(timeout=30)
# Save results to local files
pdf_path = conversion.to_pdf_file(path='output/equation.pdf')
md_path = conversion.to_md_file(path='output/equation.md')
# Optional: access content in memory
pdf_bytes = conversion.to_pdf_bytes()
md_text = conversion.to_md_text()
After running this script, the following files will be saved locally:
output/equation.pdf
– the formatted PDF outputoutput/equation.md
– the Markdown version of the input
Output Options Summary
- Use
to_*_file(path)
methods to save results directly to disk. - Use
to_*_bytes()
orto_*_text()
for in-memory access (useful for web services or databases). - You can request multiple formats in the same API call by setting multiple
convert_to_*
flags. - Not all formats are supported for all input types — see the full conversion spec.