用一個 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 常見問題