關於本站

授權 · 方法 · 免責聲明 · 版本釘選

本站是什麼

本站是 microsoft/markitdown 的 非官方繁體中文教學站。目標是把整個 repo（程式碼、轉換器、CLI、外掛、MCP、 Azure 整合、測試）做成「中英對照」的策展式解說——不逐檔鏡像，而是挑「值得教學」的內容深入講解。

方法

我們怎麼跑的

  1. 建立 uv 虛擬環境，從對齊 commit 的源碼安裝 markitdown[all]（0.1.7）。
  2. 用 scripts/generate-samples.py 產生各格式樣本輸入檔（python-docx / openpyxl / python-pptx / reportlab / Pillow / piexif）。
  3. 對每種格式執行 markitdown <file> -o out.md，把真實輸出收進 worked/conversions/。
  4. 用 markitdown 轉 markitdown 自己（README / pyproject.toml / Dockerfile / GitHub 頁 / PyPI 頁）作 dogfooding。
  5. 用 graphify 0.9.40（--code-only，純本機 AST）掃描源碼，產出互動知識圖譜與 GRAPH_REPORT。
  6. 把 graph.html 中文化成 graph-zh.html（UI 字串替換，節點標籤保留英文）。
授權：本站內容以 MIT License 釋出（與上游相同）， LICENSE 為照抄自上游的 MIT 全文；NOTICE 為本站自行撰寫 （非官方教學站聲明、引用範圍、原創內容授權）。
商標：MarkItDown 與 Microsoft 為 Microsoft Corporation 或其關聯公司之商標。 MIT 授權不含商標授權；本站僅在「描述性／教學」語境使用該名稱，並於全站 footer 標示「與 Microsoft 無關」。

免責聲明

本站為第三方社群教學站，與 Microsoft、AutoGen Team 無關，不代表 MarkItDown 官方立場。本站未散布官方二進位，僅引述實際運行輸出與解說上游文件。

上游同步

對齊上游分支 main，釘選 commit fd239d5 （發行版 v0.1.7，2026-07-29）。.github/workflows/check-upstream.yml 每月 1 日自動檢查 上游最新 SHA 並更新首頁徽章，也可手動觸發。

回饋與貢獻

發現翻譯錯誤或想補充主題，歡迎到 GitHub Issues 開 issue； 想貢獻轉換案例，依 README 流程發 PR。