文件教學

把官方文件翻成中英對照的解說——策展式教學，不逐檔鏡像

語料來源：根目錄 README.md（360 行）· packages/markitdown/README.md · markitdown-mcp/README.md · markitdown-ocr/README.md · markitdown-sample-plugin/README.md

⚙️ 運作原理 How It Works convert() 調度管線：StreamInfo 猜測 → magika 內容偵測 → priority 排序 → accepts → convert → 輸出標準化。 🏗️ 架構總覽 Architecture 4 個套件 + 核心類別職責表：MarkItDown、DocumentConverter、ConverterRegistration、StreamInfo。 🧩 轉換器全覽 Converters 22 個轉換器逐一解說：格式、依賴、priority、輸出結構、限制。 ⌨️ CLI Reference CLI 指令參考 markitdown 全部旗標：-o / -x / -m / -c / -d / --use-cu / -p / --list-plugins… 🐍 Python API Python API 5 個 convert_* 方法、StreamInfo 線索卡、DocumentConverterResult 回傳值。 🔌 Plugins 外掛系統 entry-point 群組、enable_plugins、markitdown-ocr、sample-plugin 開發教學。 🔗 MCP Server markitdown-mcp STDIO / Streamable HTTP / SSE 三種傳輸、Docker、Claude Desktop、安全限制。 ☁️ Azure Cloud Azure 雲端轉換 Document Intelligence vs Content Understanding 對照表 + 計費注意。 🐳 Docker Docker 建映像、stdin 管道轉換、mcp Docker 啟動。 🛡️ Security 安全模型 I/O 權限等同目前程序、Sanitize inputs、只用最窄的 convert_* 函數。 🎮 Worked Examples 實作案例 11 種格式真實轉換 + graphify 互動圖——真實工具產出的示範。