REST API

Convert documents to Markdown programmatically. Single endpoint, all formats supported.

Endpoint

POST https://www.docstomarkdown.com/api/convert

Request

curl -X POST https://www.docstomarkdown.com/api/convert \
  -F "file=@document.pdf"

# Optional parameters
curl -X POST https://www.docstomarkdown.com/api/convert \
  -F "file=@document.pdf" \
  -F "format=pdf" \
  -F "postprocessors=normalize-headings,fix-tables"

Response

{
  "success": true,
  "markdown": "# Title\n\nContent...",
  "metadata": {
    "format": "pdf",
    "originalSize": 48200,
    "pageCount": 5
  },
  "warnings": [],
  "stats": {
    "inputBytes": 48200,
    "outputBytes": 12400,
    "durationMs": 340,
    "postprocessorsApplied": [
      "normalize-headings",
      "fix-tables"
    ]
  }
}

Fields

filerequiredThe document file to convert (multipart form data)

formatoptionalForce a specific input format (pdf, docx, html, etc.)

postprocessorsoptionalComma-separated list: normalize-headings, fix-tables, normalize-whitespace, clean-inline-html, preserve-code-blocks

optionsoptionalJSON object: {"password": "...", "frontmatter": true}

Start converting documents programmatically.

Try the web converter →