文件转 Markdown API 文档

文件转 Markdown · API 文档

POST 接口概述无需鉴权

https://cuobiezi.net/api/v1/tools/convert/to-markdown

将图片、PDF、Word 文档上传后，返回对应的 Markdown 纯文本内容。

请求参数

Content-Type：multipart/form-data

字段名	类型	必填	说明
`file`	文件	必填	待转换的文件，支持格式：图片：`.jpg` `.jpeg` `.png` `.gif` `.webp` 文档：`.pdf` `.docx` 最大文件大小：20 MB

响应说明

成功时 Content-Type 为 text/plain; charset=utf-8，响应体即为 Markdown 文本。

失败时 返回对应 HTTP 状态码，响应体为纯文本错误描述。

HTTP 状态码	原因	响应体示例
200	转换成功	`# 标题\n\n正文内容...`
400	未上传文件 / 文件类型不支持 / 文件超过 20MB	`不支持的文件类型，仅支持：图片...`
500	服务内部错误 / Cloudflare API 调用失败	`文件转换失败，请检查文件内容后重试`

调用示例 · curl

上传 PDF 文件：

# 上传 PDF，输出 Markdown 到终端 curl -X POST https://cuobiezi.net/api/v1/tools/convert/to-markdown \ -F "file=@/path/to/document.pdf"

上传图片并保存结果：

# 上传图片，保存 Markdown 到文件 curl -X POST https://cuobiezi.net/api/v1/tools/convert/to-markdown \ -F "file=@/path/to/image.png" \ -o output.md

上传 Word 文档（DOCX）：

# 上传 DOCX 文件 curl -X POST https://cuobiezi.net/api/v1/tools/convert/to-markdown \ -F "file=@/path/to/report.docx"

调用示例 · Python

import requests url = "https://cuobiezi.net/api/v1/tools/convert/to-markdown" with open("document.pdf", "rb") as f: resp = requests.post(url, files={"file": f}) if resp.status_code == 200: print(resp.text) # Markdown 内容 else: print(f"Error {resp.status_code}: {resp.text}")

注意事项

· 本接口为公开接口，无需 API Key 或登录凭证。

· 文件大小限制为 20 MB，超出将返回 400 错误。

· 图片转换效果取决于图片清晰度，建议使用高分辨率图片。

· 本接口不存储用户上传的文件，文件处理完毕后立即释放。