office-to-md 是做什麼的？
將 Microsoft Office 文件轉換為 Markdown 格式，以便順暢與 AI 代理及開發者工具整合。
概述
此技能會讀取 Office 檔案（.docx、.xlsx、.pptx），並將其結構化內容（文字、表格、投影片等）輸出為 Markdown。常見使用案例包括：
- 將舊版 Office 文件轉換為 AI 代理可讀取的格式。
- 從試算表或簡報中萃取結構化資料。
- 將 Office 內容自動化整合至知識庫或開發者工作流程。
支援的平台
此技能相容於：
- Claude Code（Anthropic）
- Cursor（AI 驅動的編輯器）
- Codex（AI 終端機）
使用方式
您可透過提供 Office 檔案的路徑來呼叫此技能。例如，轉換 Word 文件：
office-to-md document.docx
轉換 Excel 試算表：
office-to-md spreadsheet.xlsx
轉換 PowerPoint 簡報：
office-to-md presentation.pptx
輸出選項
- 單一 Markdown 檔案：預設會將整個文件輸出為單一 .md 檔案。
- 拆分輸出：針對大型文件或投影片組，可選擇拆分為多個 Markdown 檔案（例如每張投疊一個檔案）。使用
--split旗標：
office-to-md presentation.pptx --split
功能
- 從 Word 文件中擷取文字與基本格式（標題、粗體、清單）。
- 從 Excel 文件中萃取表格與儲存格資料。
- 從 PowerPoint 文件中提取投影片內容與備忘稿。
- 處理內嵌圖片（會以 base64 編碼或替代文字形式包含在 Markdown 中）。
- 處理追蹤修訂（於 Word 中），並嘗試簡化輸出。
限制
- 無法完美保留複雜的 Office 版面配置（例如文字框、精確定位）。
- 巨集或動態內容無法擷取。
- 須在環境中安裝 Pandoc 或等效工具（請參閱安裝說明）。
安裝
請確認已安裝 Python 3.8 以上版本及 Pandoc。然後執行：
pip install office-to-md
或者，如果您偏好使用 Docker：
docker pull office-to-md:latest
範例
將 Word 文件轉換為 Markdown：
office-to-md report.docx > report.md
將 Excel 試算表轉換為 Markdown 表格：
office-to-md data.xlsx --format table > data.md
將 PowerPoint 簡報轉換為個別投影片檔案：
office-to-md slides.pptx --split --output-dir ./slides/
疑難排解
- 「找不到 Pandoc」錯誤：請安裝 Pandoc（https://pandoc.org/installing.html）。
- 圖片未出現：檢查是否提供
--images旗標（如有）。 - 表格格式錯亂：使用
--table-mode選項進行實驗。
授權
MIT