用一个 API 将各种文件转换为 Markdown

接口

通过文件 URL 转换

POST JSON 中传入 file_url（也支持 url），即可代替上传 file。URL 没有扩展名时，可用 filename 指定原始文件名。output_format 支持 markdown 或 text。每次请求转换一个文件，沿用 Word2MD API 密钥、每日额度和积分计费。

curl -X POST https://www.word2md.net/api/v1/convert \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"file_url":"https://files.example.com/report.pdf","filename":"report.pdf","output_format":"markdown"}'

使用公网 HTTPS 文件直链或有效的签名下载链接，端口为 443。不支持登录页面、浏览器 Cookie、自定义下载请求头和内网地址。下载上限为 50 MB、60 秒、5 次重定向。文件 URL 不会保存；下载或转换失败不计入成功调用次数，已预扣的付费积分会退回。

飞书多维表格等工具的 HTTP action 配置

选择 POST 和 Form URL Encoded（application/x-www-form-urlencoded），请求头填写 Authorization: Bearer YOUR_WORD2MD_API_KEY。将 file_url 映射到下载链接，filename 映射到文件名，output_format 设为 markdown，再将 JSON 响应中的 content 写回表格。表单编码可以保留签名链接中的特殊字符，无需手动拼接 JSON。

curl -X POST https://www.word2md.net/api/v1/convert \
  -H "Authorization: Bearer sk-your-key" \
  --data-urlencode "file_url=https://files.example.com/report.pdf" \
  --data-urlencode "filename=report.pdf" \
  --data-urlencode "output_format=markdown"

飞书附件预览链接不是公开下载直链。请先通过有文件读取权限的飞书应用获取临时下载链接，再把该链接传给 Word2MD。不要向 Word2MD 发送飞书 Cookie 或访问令牌。多个附件请逐个请求转换。

支持的文件类型

支持常见办公文档、PDF、表格、演示文稿、结构化数据、媒体、压缩包和图片。

额度与计费

每个账户每天都有 API 免费额度。用完套餐额度后，每次成功转换会从订阅余额或一次性加油包中扣除 1 积分。

返回格式

成功转换会返回转换内容、原始文件名、输出格式、扣除积分以及更新后的用量。

{
  "success": true,
  "object": "conversion",
  "content": "# Report\n\n...",
  "format": "markdown",
  "filename": "report.pdf",
  "credits_charged": 0,
  "usage": { "tier": "free", "used": 1, "daily": 50, "remaining": 49 }
}

错误与状态码

错误会以 JSON 返回，并包含稳定的错误码和可读的错误信息。

生产环境建议

• 使用 HTTPS，并将密钥保存到环境变量
• 上传前校验文件大小
• 对临时 5xx 错误使用指数退避重试
• 读取 usage 对象跟踪剩余额度
• 处理完成后删除敏感文件

API 常见问题