---
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解析

---

# 快速开始

```bash
cd ~/.openclaw/skills/excel-to-md
python3 excel_to_md.py <excel文件路径> [选项]
```

---

## 核心功能

### 1. Excel → Markdown（默认）
```bash
python3 excel_to_md.py /path/to/file.xlsx
# 输出到 同目录/file.md
```

### 2. 指定输出路径
```bash
python3 excel_to_md.py /path/to/file.xlsx -o /path/to/output.md
```

### 3. 转换前预览（不写文件）
```bash
python3 excel_to_md.py /path/to/file.xlsx --preview
```

### 4. 查看工作表列表
```bash
python3 excel_to_md.py /path/to/file.xlsx --list-sheets
```

### 5. 只转换指定工作表
```bash
python3 excel_to_md.py /path/to/file.xlsx --sheet "Sheet1"
```

### 6. 批量转换目录下所有 Excel
```bash
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      # 输出格式规范
```