Skip to main content

Supported Formats

Input formats

Documents

Accepted by POST v3/pdf. Maximum file size: 1 GB.

FormatExtensions
PDF.pdf
EPUB.epub
Microsoft Word.docx, .doc
Microsoft PowerPoint.pptx
Amazon Kindle.azw, .azw3, .kfx
Mobipocket.mobi
DjVu.djvu
WordPerfect.wpd
OpenDocument Text.odt

Images

Accepted by POST v3/text, POST v3/latex, and POST v3/strokes. Images are decoded using OpenCV.

FormatExtensions
JPEG.jpeg, .jpg, .jpe
PNG.png
Windows bitmap.bmp, .dib
JPEG 2000.jp2
WebP.webp
Portable image format.pbm, .pgm, .ppm, .pxm, .pnm
PFM.pfm
Sun raster.sr, .ras
TIFF.tiff, .tif
OpenEXR.exr
Radiance HDR.hdr, .pic
GDALRaster and vector geospatial data

Markdown

Accepted by POST v3/converter. Passed as a JSON string in the mmd field. Maximum body size: 10 MB.

FormatDescription
MMDMathpix Markdown

Output formats

All endpoints return Mathpix Markdown (MMD) as the primary output. The v3/pdf and v3/converter endpoints can additionally convert into DOCX, LaTeX, HTML, PDF, PPTX, and ZIP variants.

Conversion Formats

info

This parameter is called formats for v3/converter and conversion_formats for v3/pdf.

The value is a JSON object where each key is a format extension from the table below and the value is:

  • true to enable
  • false to disable
Example
{"docx": true, "tex.zip": true}

List of supported extensions

ExtensionAvailabilityDescription
docxConversionMicrosoft Word document
htmlConversionHTML file
html.zipConversionZip archive containing HTML and inline images
latex.pdfConversionPDF with LaTeX rendering
lines.jsonAlways (v3/pdf only)Line-by-line JSON data
lines.mmd.jsonAlways (v3/pdf only, deprecated)Line-by-line MMD JSON data
mdConversionPlain Markdown
md.zipConversionZip archive containing Markdown and inline images
mmdAlwaysMathpix Markdown text file
mmd.zipConversionZip archive containing Mathpix Markdown and inline images
pdfConversionPDF with HTML rendering
pptxConversionPowerPoint presentation
tex.zipConversionZip archive containing LaTeX and inline images

The Availability column indicates when a format is ready:

  • Always — generated automatically during processing. Ready to download as soon as the job completes.
  • Conversion — must be requested explicitly using formats (v3/converter) or conversion_formats (v3/pdf). You can also download any format on demand by calling GET .{ext} without pre-requesting it — the API will convert it at that point and return the result once ready.
note

For ZIP formats, images are embedded in the archive and referenced within the document:

tex.zip
\includegraphics[max width=\textwidth]{image-name}
mmd.zip and md.zip
![](./images/image-name.jpg)
html.zip
<img src="./images/image-name.jpg" alt="">

See Conversion Options for per-format settings.