面向开发者的 Markdown Converter API
通过单个 REST 端点以编程方式转换 Markdown、PDF、Word 和 HTML。完整支持 LaTeX 数学公式和 Mermaid 图表渲染，服务已就绪，任意语言均可调用。在 RapidAPI 获取 API Key，几分钟内即可开始转换。
Markdown 转换 API 快速入门
两步即可完成：提交文件获取任务 ID，然后轮询下载链接。所有端点均遵循同一模式。
# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }
# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }1. 提交转换任务
发送文件上传（source_file）或公开文件链接（source_file_url），接口返回一个 task_id。
2. 轮询获取结果
携带 task_id 轮询 query-task，直到 status 变为 completed，然后从 to_url 下载文件。
Markdown 转 PDF、Word 和 HTML API 端点
所有端点均接受 multipart/form-data 格式的 POST 请求，并返回 task_id。基础路径：/apix。
| 请求方式 | 端点 | 说明 | 在线工具 |
|---|---|---|---|
| POST | /apix/md-to-pdf | 将 Markdown 转换为 PDF，完整渲染 LaTeX 公式和 Mermaid 图表。 | 在线试用 |
| POST | /apix/md-to-docx | 将 Markdown 转换为可编辑的 Word（.docx）文档。 | 在线试用 |
| POST | /apix/md-to-html | 将 Markdown 转换为简洁、语义化的 HTML。 | 在线试用 |
| POST | /apix/pdf-to-md | 从 PDF 中提取 Markdown 内容，包括文字、表格和图片。 | 在线试用 |
| POST | /apix/docx-to-md | 将 Word（.docx）文档转换为 Markdown。 | 在线试用 |
| POST | /apix/html-to-md | 将 HTML 页面或片段转换为简洁的 Markdown。 | 在线试用 |
| POST | /apix/query-task | 通过 task_id 查询任务状态，并在就绪时获取下载链接。 | — |
异步转换 API 的工作原理
转换任务异步执行，大文件不会阻塞您的请求。
提交任务
将 Markdown、PDF、Word 或 HTML 文件以上传或公开 URL 的方式 POST 到对应端点。
获取任务 ID
API 立即返回 task_id，状态为 processing，无需长时间保持连接。
轮询并下载
携带 task_id 调用 query-task，当 status 变为 completed 时，从响应中的 to_url 下载文件。
Markdown Converter API 的渲染能力
从 LaTeX 公式到 Mermaid 图表，API 可将复杂 Markdown 高保真地转换为 PDF、Word 和 HTML。
LaTeX 数学公式
行内和块级 LaTeX 公式在 PDF 和 Word 输出中均可准确渲染，非常适合学术和技术类文档。
Mermaid 图表
用 Mermaid 编写的流程图、时序图、甘特图和类图，均可渲染为真实图形。
完整 GFM 支持
管道表格、任务列表、带语法高亮的围栏代码块、删除线和自动链接——全部完整保留。
双向转换
支持将 Markdown 转换为 PDF、Word 和 HTML，也可将这些格式逆向转换为简洁的 Markdown，便于版本控制。
Markdown 转换 API 使用场景
开发者借助该 API 在构建流水线、产品功能和批量任务中自动生成文档。
CI/CD 流水线
在每次构建时自动从 Markdown 生成发布说明、报告或 PDF 产物，无需维护无头浏览器。
文档工具链
自动将 Markdown 文档转换为可下载的 PDF 或 Word，供用户、客户或离线阅读使用。
批量转换
通过传入公开文件 URL 在服务端批量处理大量文档，然后按 task ID 收集转换结果。
Markdown Converter API 定价
API 通过 RapidAPI 按量计费，提供免费额度供快速上手，付费套餐可随用量弹性扩展。账单、密钥和频率限制均在您的 RapidAPI 账户中统一管理。
Basic
30
次请求/月
Pro
800
次请求/月
+ $0.02 / request
Ultra
4,000
次请求/月
+ $0.012 / request
Mega
12,000
次请求/月
+ $0.008 / request
配额和价格由 RapidAPI 设定，可能随时调整——请查看实时套餐页面获取最新详情。
在 RapidAPI 查看套餐Markdown API 集成常见问题
首次接入的开发者所需了解的一切：如何订阅、鉴权、发送请求以及选择合适的套餐。
如何开始使用 Markdown 转换 API？
注册一个免费 RapidAPI 账户，在 RapidAPI Hub 中打开 Markdown Converter Pro API 并订阅套餐——Basic 套餐免费。订阅后，即可直接使用上方的代码示例调用任意端点。
在哪里可以找到我的 API Key？
订阅后，RapidAPI 会为您的账户生成一个专属 API Key。您可以在 RapidAPI 控制台以及任意端点的 Code Snippets 标签页中找到它。每次请求时，请将其作为 X-RapidAPI-Key 请求头发送，同时附上对应的 X-RapidAPI-Host 请求头。
API 支持哪些转换类型？
API 提供六个转换端点——Markdown 转 PDF、Word 和 HTML，以及 PDF、Word 和 HTML 逆向转回 Markdown——另有一个用于查询结果的 query-task 端点。各端点的具体路径详见上方的端点列表。
转换请求需要传哪些参数？
每个转换端点接受 multipart/form-data 格式的请求，包含两个字段之一：source_file 用于直接上传文件，source_file_url 用于指向一个公开可访问的文件地址。二选一传入，若同时传入，source_file 优先生效。文件大小不超过 50 MB，且文件类型必须与端点匹配，例如 md-to-pdf 端点需要传入 .md 文件。
如何获取转换后的文件？
转换任务异步执行，因此成功的请求返回的是 task_id 而非文件本身。将该 task_id 传入 query-task 端点持续轮询，直到 status 变为 completed，然后从响应中的 to_url 下载转换完成的文件。
转换失败时会发生什么？
如果转换无法完成，query-task 返回的 status 将为 failed 而非 completed。常见原因包括：文件类型与端点不匹配、source_file_url 无法公开访问，或文件大于 50 MB。请检查并修正输入后重新提交请求。
应该选择哪个定价套餐？
建议先使用免费的 Basic 套餐测试集成，随着月请求量增长再升级为付费套餐。每个套餐包含月度请求配额，超出后按单次请求收取少量费用——上方定价表展示了当前各档套餐详情。账单和限额均在您的 RapidAPI 账户中管理。
转换后我的文件会被保留吗？
您的文件不会被留存。上传的文档和转换后的输出文件仅作临时处理，处理完毕后即被删除。转换完成的文件通过有时效的下载链接提供，不会长期存储。