MarkUDown

PDF 转 Markdown API — MarkUDown PDF 转换 API 文档

POST/api/pdf-to-markdown

PDF 转 Markdown

上传 PDF,即可以 Markdown 形式取回其文本,标题根据字号自动识别。请求是同步的:Markdown 直接在响应中返回。

参数类型必填默认值描述
filefile (multipart/form-data)必填—PDF 文件,以 multipart/form-data 发送。最大 200 MB。

请求

curl -X POST https://api.scrapetechnology.com/api/pdf-to-markdown \
  -H "X-API-KEY: your-api-key" \
  -F "file=@report.pdf"

响应

{
  "filename": "report.pdf",
  "title": "Annual Report",
  "markdown": "# Annual Report\n\nFirst paragraph...",
  "page_count": 12,
  "pages_processed": 12,
  "truncated": false
}

文本取自 PDF 的文字层:扫描版 PDF(仅图像)几乎不会返回文本,表格和分栏也不会被还原。

每个文件最多读取 500 页;如有页面未读取或文本被截断,truncated 为 true。title 是 PDF 自带的标题,没有时使用文件名。

费用: 每读取 10 页消耗 1 个积分(最少 1 个),转换成功后扣除。

错误

状态码含义
400文件不是 PDF。
413文件超过 200 MB。
422无法读取该 PDF(可能已损坏或受密码保护)。
504转换超时。