让 Agent 直接转换文档，而不用自己搭建解析管线。
JustMarkdown 提供面向 Agent 工作流的异步转换 API。每份文档提交一个任务、轮询直到完成，再下载 Markdown——此外还有同步的 Markdown → PDF 接口。无需自己搭建 OCR 或 PDF 解析管线。
API key 仅用于远程 MCP 端点 /api/mcp；任务接口 /api/jobs 使用登录会话或访客 Cookie。
# One request in, one job out curl -X POST https://justmarkdown.com/api/jobs \ -F "files=@paper.pdf" \ -F "formatSlug=pdf-to-markdown" \ -F "mode=single" # → 200 OK { "job": { "id": "job_a1b2c3d4", "status": "queued", "results": [], "zipDownloadUrl": null } }
一个请求进来，一个任务返回。
提交文档、轮询状态、下载结果，这就是完整闭环。
每份文档提交一个任务
将文件 POST 到 /api/jobs 并指定 formatSlug 与 mode，拿回任务 ID 和轮询地址。
轮询直到完成
GET /api/jobs/{jobId} 查看状态，当 status 变为 "completed" 时，results 中的下载地址即可用。
完成后再下载
从 /api/jobs/{jobId}/artifact 获取渲染好的 Markdown。文件在完成后保留 24 小时。
七个端点，仅此而已。
同步 Markdown → PDF
发送 JSON（markdown + theme + pageSize），直接返回 PDF 二进制流。无需鉴权，适合一次性渲染。
提交异步转换任务
Multipart 上传文件（files + formatSlug + mode）。返回 job 对象与状态轮询地址。需登录或访客 Cookie，并通过 Cloudflare 验证；扫描件 OCR 需登录。扫描版 OCR 按 1 积分/页计费（文本型 PDF 免费），音频按 1 积分/分钟。
轮询任务状态
返回 job 的 status（queued / processing / completed / failed）及 results 下载链接。
下载产物
按 fileId 下载单个 Markdown 产物，或传 type=zip 下载批量 ZIP。完成后 24 小时内可用。
SSE 事件流
Server-Sent Events 实时推送任务状态变更，无需轮询。连接保持到 completed 或 failed。
同步 Markdown → Word
发送 Markdown（可选 template 与图片），直接返回 .docx 文档。
远程 MCP 端点
Streamable HTTP MCP 端点，提供 convert_url、convert_base64 等工具，可被 Claude、Cursor 等客户端直接调用。账户 API Key 每次转换固定 1 积分。
把它当作 MCP 工具使用。
同一 API 也以 Model Context Protocol 工具形式提供——直接接入 Claude、Cursor 或任何 MCP 兼容的 Agent。
// claude_desktop_config.json — remote, nothing to install, documents → Markdown { "mcpServers": { "justmarkdown": { "type": "http", "url": "https://justmarkdown.com/api/mcp", // Optional: omit for the anonymous free tier (a few conversions per day). "headers": { "Authorization": "Bearer jm_live_…" } } } }
// claude_desktop_config.json — local stdio bridge to the remote tools { "mcpServers": { "justmarkdown": { "command": "npx", "args": ["-y", "justmarkdown"] } } }
API 能做什么。
异步任务队列
提交后即可离开，方便时再轮询，或订阅 SSE 事件流。多数文档几秒内完成；扫描件 OCR 可能需要几分钟。
Markdown → PDF
当前渲染目标为 PDF，无需自己拼装浏览器打印 CSS。
MCP 兼容
同一 API 也以 Model Context Protocol 工具形式提供，可直接接入 Claude、Cursor 等 MCP 兼容 Agent。
SSE 进度推送
订阅 /api/jobs/{jobId}/events 实时获取状态变化，无需轮询。
API key 鉴权（MCP）
API key（Authorization: Bearer 或 x-api-key）用于远程 MCP 端点 /api/mcp；任务接口使用登录会话或访客 Cookie。
面向 Agent 编排
为 Agent 工作流设计的异步转换 API，长渲染任务不会阻塞你的 worker 循环。
开发者 API 常见问题。
需要 API key 吗？
不需要。API key（在账户设置中创建）只用于远程 MCP 端点 /api/mcp；/api/jobs 与 /api/v1/convert 使用登录会话或访客 Cookie。
有「文档 → Markdown」的异步接口吗？
有。把文件 POST 到 /api/jobs，轮询 /api/jobs/{jobId} 或订阅 SSE，再从 /api/jobs/{jobId}/artifact 下载 Markdown。
能在 Claude 或 Cursor 里直接调用同一套引擎吗？
可以。同一引擎以 MCP 工具形式提供，把客户端指向 /api/mcp 远程端点即可；配置见 MCP 指南。