PDF to Markdown
Turn a PDF into a Markdown file you can drop into a wiki, a static site, or an LLM pipeline.
API Endpoint
POST /api/v1/tools/pdf/pdf-to-markdown
Accepts multipart form data with a PDF file.
Parameters
This tool has no configurable parameters. Upload a PDF and get a .md file back.
Example Request
bash
curl -X POST http://localhost:1349/api/v1/tools/pdf/pdf-to-markdown \
-H "Authorization: Bearer si_your-api-key" \
-F "[email protected]"Example Response
json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/report.md",
"originalSize": 520000,
"processedSize": 14300,
"chars": 14300
}A large PDF can take longer than the sync window. The API then answers 202 with a jobId, and you follow progress at /api/v1/jobs/{jobId}/progress.
What gets kept
A PDF stores positioned text, not structure, so the converter infers it:
- Headings. Short lines set clearly larger than the body text become
#to######headings, ranked by size across the whole document. - Lists. Lines that start with a bullet or a number become list items.
- Bold, italic and links. Kept inline. Only
http,httpsandmailtolinks survive. - Tables. Tables drawn with ruling lines come out as Markdown tables. Tables laid out with spacing alone usually come through as plain paragraphs.
Images are dropped. Multi-column layouts and unusual page designs are best-effort, so check the output before you rely on it.
Notes
- Accepted input format:
.pdf. - The
charsfield in the response is the length of the Markdown output. - A scanned PDF has no text layer to convert. The tool refuses it with
422and the codeNO_TEXT_LAYERinstead of returning an empty file. Use the PDF OCR tool for those. - For the round trip, Markdown to PDF, Markdown to DOCX and Markdown to HTML read
.mdfiles.
