Convert

Convert between PDF and 50+ file formats including documents, images, web pages, and more.

How to Use#

Select conversion type - Choose what you're converting from and to
Upload files - Add one or multiple files
Configure options - Adjust quality, DPI, layout (optional)
Convert - Process and download

Supported Conversions#

Convert TO PDF#

Category	Formats
Office	DOCX, DOC, ODT, XLSX, XLS, ODS, PPTX, PPT, ODP, TXT, RTF
Images	JPG, JPEG, PNG, GIF, BMP, TIFF, WEBP, SVG
Web	HTML (with CSS/images via ZIP), URL, Markdown
Email	EML, MSG (Outlook)
eBook	EPUB, MOBI, AZW3, FB2
Comics	CBZ, CBR

eBook and Outlook (MSG) inputs are converted to PDF on the self-hosted server (eBook conversion uses the bundled Calibre runtime; enable the Calibre group if your image excludes it).

Convert FROM PDF#

Category	Formats
Office	DOCX, ODT, PPTX, ODP, XLSX, TXT, RTF, Markdown
Images	PNG, JPG, GIF, TIFF, BMP, WEBP
Data	CSV, HTML, XML
Archival / Print	PDF/A, PDF/X
eBook	EPUB, AZW3
Comics	CBZ, CBR

PDF to Excel extracts tabular data and writes one worksheet per detected table. PDF to eBook (EPUB/AZW3) uses the bundled Calibre runtime. PDF/X is the print-optimized variant of PDF/A and is chosen from the same Archive / Print option (it needs Ghostscript, which is in the standard Docker image).

Conversion Options#

Image Settings (when converting to/from images)#

DPI: 72 (screen), 150 (standard), 300 (print)
Color Mode: Color, Grayscale, Black & White
Layout: Fit to page, maintain aspect ratio, fill page
Output: Single PDF or separate files

PDF to Word / Office#

Works best with digital PDFs (not scanned images)
For scanned PDFs, run OCR first
Complex layouts may need manual adjustment after conversion

PDF to CSV#

Works best with simple, well-structured tables in digital PDFs
Not reliable for scanned documents

PDF to Markdown#

Table-aware converter that runs locally on your server
Turns larger text into Markdown headings based on font size
Rebuilds detected tables as Markdown tables, joining tables that split across a page break
Works best with digital PDFs; run OCR first for scanned input

Automation and API conversions#

A few conversions have no button in the Convert tool. They run only through the API and the Automate / pipeline workflow.

PDF to vector / page-description formats - export a PDF as EPS, PS, PCL, or XPS for print and publishing workflows.
PostScript to PDF - turn PostScript files (PS, EPS, EPSF) into PDF, with an optional print-oriented (prepress) profile.

The vector and PostScript conversions need the Ghostscript group, which is included in the standard Docker image.

See the API reference for the exact parameters of these conversions.

API Usage#

bash

curl -X POST http://stirling-pdf:8080/api/v1/convert/img/pdf \
  -F "[email protected]" \
  -F "colorType=color" \
  -F "fitOption=maintainAspectRatio" \
  -o output.pdf