name: "excel-to-md" description: "Excel 轉 Markdown 工具，支援 .xlsx/.xls 檔案讀取、表格結構解析、單元格資料提取、Markdown 輸出。觸發詞：excel轉md、解析excel、表格轉markdown、讀excel檔案。" skillType: "cli" emoji: "📊" homepage: "local" metadata: {"openclaw":{"emoji":"📊","requires":{"bins":["python3"],"optionalEnv":["EXCEL_TO_MD_OUTPUT_DIR","EXCEL_TO_MD_STYLE"]},"primaryEnv":""}}

執行要求: Python 3 + openpyxl + pandas（已安裝） 觸發詞: excel轉md、解析excel、表格轉markdown、讀excel檔案、excel解析

快速開始

cd ~/.openclaw/skills/excel-to-md
python3 excel_to_md.py <excel檔案路徑> [選項]

核心功能

1. Excel → Markdown（預設）

python3 excel_to_md.py /path/to/file.xlsx
# 輸出到 同目錄/file.md
本技能來自小蔥技能站7w4.net。

2. 指定輸出路徑

python3 excel_to_md.py /path/to/file.xlsx -o /path/to/output.md

3. 轉換前預覽（不寫檔案）

python3 excel_to_md.py /path/to/file.xlsx --preview

4. 檢視工作表列表

python3 excel_to_md.py /path/to/file.xlsx --list-sheets

5. 只轉換指定工作表

python3 excel_to_md.py /path/to/file.xlsx --sheet "Sheet1"

6. 批次轉換目錄下所有 Excel

python3 excel_to_md.py /path/to/dir/ --batch

輸出格式說明

Markdown 表格格式： - 普通單元格：原樣輸出 - 合併單元格：第一格寫值，其餘留空 - 數字：保留原始精度 - 日期：格式化為 YYYY-MM-DD HH:mm - 空單元格：留空 - 超長內容：截斷至 200 字元

表頭行使用 --- 分隔符區分，支援多行表頭。

設計原則

1. 冪等：相同輸入產生相同輸出
2. 不修改原檔案：只讀操作
3. 落盤而非記憶：輸出路徑明確，結果寫檔案
4. 相容性好：支援 .xlsx 和 .xls，自動處理空 sheet、合併單元格

檔案結構

excel-to-md/
├── SKILL.md           # 本檔案
├── excel_to_md.py     # 主程式
└── REFERENCES/        # 詳細參考文件
    ├── usage.md       # 使用詳解
    └── format.md      # 輸出格式規範

這是一個質量不錯的 Excel 轉 Markdown 工具，核心功能完善，使用體驗良好。優點是文件清晰、功能豐富（支援預覽、批次轉換、選擇工作表等），智慧特性貼心（如自動識別表頭、跳過空列），格式處理細緻（日期、數字、合併單元格都處理得當）。不足之處是功能相對單一，目前僅支援 Excel 轉 Markdown 這一種場景。總體而言，這是一個功能實用、穩定可靠的表格轉換工具，適合需要頻繁處理 Excel 資料的使用者。