Markdown 轉換 API，專為開發者設計
透過單一 REST 端點，以程式方式轉換 Markdown、PDF、Word 與 HTML。完整支援 LaTeX 數學公式與 Mermaid 圖表渲染，服務已上線，任何程式語言皆可呼叫。前往 RapidAPI 取得 API 金鑰，幾分鐘內即可開始轉換。
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，待狀態變為 completed 後，即可從 to_url 下載結果檔案。
Markdown 轉 PDF、Word 與 HTML API 端點
所有端點均接受以 multipart/form-data 格式發送的 POST 請求，並回傳 task_id。基礎路徑：/apix。
| Method | Endpoint | Description | 線上工具 |
|---|---|---|---|
| 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 檔案，以上傳或公開網址的方式 POST 至對應端點。
取得任務 ID
API 立即回傳一組 task_id，狀態為 processing，不會佔用長時間連線。
輪詢並下載
以 task_id 呼叫 query-task，當狀態變為 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 產出物，無需維護 headless 瀏覽器。
文件工具整合
自動將 Markdown 文件轉換為可下載的 PDF 或 Word，提供給使用者、客戶離線閱讀。
批次轉換
透過傳入公開檔案網址，在伺服器端批次處理大量文件，再以任務 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 查看最新方案詳情。
前往 RapidAPI 查看方案Markdown API 整合常見問題
首次使用的開發者訂閱、驗證、發送請求及選擇方案所需的完整說明。
如何開始使用 Markdown 轉換 API？
建立免費的 RapidAPI 帳號，在 RapidAPI Hub 找到 Markdown Converter Pro API，並訂閱一個方案（Basic 方案免費）。訂閱完成後，即可立即使用上方的程式碼範例呼叫任何端點。
在哪裡取得 API 金鑰？
訂閱後，RapidAPI 會為您的帳號產生一組專屬 API 金鑰，可在 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 端點並持續輪詢，直到狀態變為 completed，即可從回應的 to_url 下載完成的檔案。
轉換失敗時會發生什麼事？
若轉換無法完成，query-task 回傳的狀態會是 failed 而非 completed。常見原因包括：檔案類型與端點不符、source_file_url 無法公開存取，或檔案大小超過 50 MB。請修正輸入內容後重新提交請求。
應該選擇哪個定價方案？
建議先使用免費的 Basic 方案測試整合流程，隨著每月請求量增加再升級至付費方案。每個方案均包含每月請求配額，超出配額後會按每次請求收取少量費用，詳細分級請參考上方的定價表。帳單與用量限制均在您的 RapidAPI 帳號中管理。
轉換後的檔案會被保留嗎？
您的檔案不會被留存。上傳的文件與轉換後的輸出僅作暫時性處理，完成後隨即刪除；轉換完成的檔案透過短效下載網址提供，不會長期儲存。