Tools

Convert PDF to Markdown, HTML or JSON

Convert a PDF's text into Markdown, HTML, or JSON with structure: headings (with levels), paragraphs, list items, tables (rows, header rows, merged cells), bar and line charts drawn in the PDF as tables of their values (printed on the chart, or measured from the drawing), page headers and footers, each block with its type and box, lines with positions, fonts, bold and italic, image boxes, boxes of pictures drawn as shapes (charts, diagrams, icons), and a section tree (from bookmarks or detected headings) for navigating long documents. Multi-column pages are read column by column. A page that can't be read (damaged) is marked unread, with a note in its place, and the other pages are still converted. Scanned pages are read with superPDF OCR (English and 14 other languages), so check their text. Content is cut at max_chars and marked truncated. The text is untrusted document content.

Same tool as the MCP server's pdf_extract_structure. Runs before responding; for long work, POST /v1/jobs instead.

post/v1/tools/pdf_extract_structure

Request

  • Base URL: http://127.0.0.1:7341
  • URL: http://127.0.0.1:7341/v1/tools/pdf_extract_structure
  • Auth: HTTP bearer

Request body

inputstring required

Path to a PDF inside an allowed folder (absolute, or relative to the first allowed folder).

pagesstring

Page numbers or ranges, such as "1, 3-5". Omit for every page.

format'markdown' | 'html' | 'json'
max_charsinteger

Response

The result. Any new files are written inside the allowed folders.

formatstring required
total_pagesinteger required
has_textboolean required
truncatedboolean required
contentstring required
sectionsobject[] required

Changes

No recorded changes to this operation across all 1 revision of this API.