前言¶
把 .pptx 轉成 Markdown，常見做法是拿 markitdown 或 pandoc 跑一次，拿到文本就算完事。問題在於：轉換丟了幾頁、正文召回了多少、備註和圖片去哪了，都無從驗證。出報告時只能口頭承諾”基本無損”。
下面介紹的 Skill 把這件事拆成可驗證的步驟：先預檢分級，再探測可用後端，然後做結構降維轉換，最後產出帶頁覆蓋率、文本召回率和置信度分級的質量報告。它是編排與質量保障層，不自研 PPT 解析引擎，複用成熟的第三方後端。
這是什麼¶
「PPT 轉 Markdown」是一個 community 來源的 Agent Skill，座標 @user_989eb8f0/tri-pptx2md，當前版本 1.4.5，分類爲 office-efficiency，發佈者 user_989eb8f0。SkillHub 頁面顯示評分 100000、下載 919 次（抓取時點數據），標籤 requires_api_key=false，即不需要 API Key。
它解決的問題是：PowerPoint/WPS 演示文稿轉 Markdown 時，頁數、文本、備註、圖片的丟失情況不可見。Skill 的定位是編排與質量保障層，把「無損」這個口頭承諾落成可計算、可分級、可追溯的質量報告。
核心功能¶
Skill 內部是四門管道，按順序執行：
- 預檢分級：用文件類型魔數判定真實格式，統計頁數、備註、圖片計數，並標記舊格式文件。
- 後端探測與編排：探測環境裏可用的轉換後端，anydoc 全族直讀作爲首選，不可用時走降級鏈。
- 結構降維轉換：逐頁輸出 Slide 塊，內含標題、正文、備註和圖片引用。
- 質量校驗：對比源文件與轉換結果，輸出保真度分級報告。
後端探測採用四檔降級鏈：anydoc 全族直讀首選，隨後依次降級到 python-pptx、markitdown、pandoc、LibreOffice。某一後端不可用時不直接失敗，而是繼續探測下一級。
輸入覆蓋 .pptx/.pptm/.pps/.pot/.ppsx/.ppsm/.ppt 同族七擴展名，包括舊格式 .ppt。
質量報告給出可計算的指標：頁覆蓋率、文本召回率、丟失率、結構對比結果，並按置信度分 A/B/C 三級。報告裏每個 Slide 塊對應源文件的一頁，可以逐頁追溯。
上游依賴檢測有三態邏輯：快照模式直接用現有依賴，引導安裝模式提示補裝缺失項，降級模式在依賴不全時仍盡力完成轉換。
安裝與啓用¶
官方抓取資料中未給出具體的安裝命令和配置字段，本文不臆造。獲取方式爲訪問官方頁面：
https://www.skillhub.cn/skills/user_989eb8f0/tri-pptx2md
安裝與啓用細節以官方頁面說明爲準。該 Skill 基於通用 SKILL.md 格式，支持獨立安裝。
典型用法¶
官方簡介未提供逐條的調用示例，下面根據其能力描述觸發方式，細節以官方資料爲準。
- 將 .pptx（或同族七種擴展名之一）文件交給 Skill。
- Skill 先做預檢分級：判定真實文件類型、頁數、備註和圖片數量，標記舊格式。
- 探測可用後端，從 anydoc 開始，按 python-pptx → markitdown → pandoc → LibreOffice 順序降級。
- 執行結構降維轉換，輸出每頁一個 Slide 塊，含標題、正文、備註、圖片引用。
- 產出質量報告：頁覆蓋率、文本召回率、丟失率、結構對比、置信度 A/B/C 分級。
適用場景與注意¶
適合這類場景：需要把演示文稿沉澱爲文本資產，同時要能回答「轉了幾頁、丟了多少、哪頁有問題」。轉換結果要進知識庫、要做歸檔校驗的，用這個 Skill 比單次跑轉換工具多了一層可驗證性。
注意幾點：
- Skill 不自研解析和渲染引擎，轉換質量取決於降級鏈上可用後端的表現。
- 舊格式 .ppt 依賴後端支持，預檢階段會打上舊格式標記。
- 質量報告的置信度分級反映的是本次轉換的可驗證程度，不是文件本身的質量。
- 官方資料未給出安裝命令與配置字段，落地前需從官方頁面確認。
結尾¶
這個 Skill 的價值在於把「PPT 轉 Markdown」從一次不可見的黑盒轉換，變成頁覆蓋率和文本召回率可計算、置信度可分級、每頁可追溯的流程。如果你的工作流裏有演示文稿轉文本這一環，值得試。
官方地址：https://www.skillhub.cn/skills/user_989eb8f0/tri-pptx2md
