1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | convert-excel-to-md-github-awesome-copilot | — |
| 作者/维护者 | GitHub（github/awesome-copilot 官方合集仓库） | GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/convert-excel-to-md | — |
| 许可证 | MIT（仓库级） | GitHub API |
| GitHub Stars / Forks | 38,098 / 4,812（属整个 awesome-copilot 合集仓库，不代表本技能自身热度） | GitHub API |
| 最新版本 | 无独立版本号，随仓库持续更新（该子技能最近一次内容改动 2026-07-16） | GitHub API（按路径过滤的提交记录） |
| 安装方式 | gh skills install github/awesome-copilot convert-excel-to-md（需 GitHub CLI），或手动复制 skills/convert-excel-to-md 整个目录到本地 skills 目录 |
仓库官方文档 |
2. 功能介绍与亮点
convert-excel-to-md 把 Excel（.xlsx）工作簿转换成 Markdown，让 agent 能准确读取、总结、搜索或从中提取数据。核心能力：
- 隐式自动触发：只要用户提到、附上或引用一个
.xlsx文件（预算表、数据导出、跟踪表），无论是否明说“转换”，都会触发；覆盖“读取”“总结”“提取”“图表”“分析”等自然语言表达。 - 按工作表分节 + 真实图片提取：每个 sheet 渲染为独立的
## <SheetName>Markdown 表格；MarkItDown 原生对嵌入图片只留截断占位符，本技能额外提取真实的嵌入图片（非图表），按所属 sheet 归类写入img/目录，并在对应表格后附“Images in this sheet”小节。 - 明确边界：SKILL.md 明确说明 Excel 原生图表对象不会被导出为图片（区别于真正的嵌入图片），避免用户误以为图表数据会连图带数一并转出。
- 批量与文件夹模式：支持单文件或整个文件夹（含
--recursive）批量转换，单个文件失败不影响批内其他文件。 - 多文件类型协同：文件夹内混有
.pdf/.docx/.xlsx时，会自动一并调用同仓库的姊妹技能 convert-pdf-to-md、convert-word-to-md，避免漏转某种格式。
3. 适用场景
固定分类：文档与办公自动化
适合需要 agent 读取并分析 Excel 工作簿内容、但 agent 本身难以直接解析 xlsx 二进制格式的场景：分析师批量整理数据导出表、财务人员核对预算与报表、运营人员从跟踪表中提取指标等。受益对象是任何会把 Excel 文件丢给 Claude Code / Codex 等 Coding Agent 处理的初中级用户，装好之后无需额外指令，agent 遇到 .xlsx 会自动先转换再分析。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 Agent Skills 格式（SKILL.md + YAML front matter），复制到
.claude/skills/目录即可使用。 - Codex：✅ 支持——仓库文档明确技能遵循开放的 Agent Skills 规范（agentskills.io），Codex CLI 官方文档同样构建在该规范之上。
- OpenClaw：未验证。
- Hermes Agent：未验证。
5. 推荐理由
Excel 的 .xlsx 是比 PDF/Word 更难被 agent 直接解析的二进制格式（多 sheet、公式、样式混杂），而多数通用文档转换工具只做粗糙的纯文本抽取。convert-excel-to-md 按 sheet 边界组织输出、把真实嵌入图片与所属 sheet 对齐，并在文档里明确标注“图表不算数”这条容易被忽视的边界，减少了用户事后排查“数据去哪了”的成本。一次性 pip 安装即可离线运行，无需付费 API；批量模式与姊妹技能协同覆盖了“整理一个文件夹混合文档”的真实工作场景。对经常需要把预算表、数据导出、报表喂给 agent 处理的用户，这是一个轻量、可审计、零成本的前置转换工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方运营的合集仓库出品；仓库整体 3.8 万星属整个合集，不代表本技能自身热度，该子技能自身尚无独立于合集之外的第三方热度证据 |
| 可用性 | 8 | 需一次性安装 MarkItDown（配有独立 setup 文档与验证命令）；SKILL.md 含 6 项故障排查表并明确图表限制；最近一次内容改动约一个月前，在近 3 个月维护窗口内 |
| 安全性 | 9 | 见下方检查清单，无扣分项 |
安全检查清单：
① Shell 命令执行——仅在本地运行随附的 Python 脚本，读写范围限于用户指定的 xlsx 文件/文件夹及其同级输出目录，无提权或系统级操作。 ② 联网外发——无，MarkItDown 为本地库，转换过程不发起任何网络请求。 ③ API Key/凭据——不需要。 ④ 可疑指令——通读 SKILL.md 与故障排查表未发现夹带无关内容或隐蔽指令。 ⑤ 作者/组织信誉——GitHub 官方合集仓库，与同批次 convert-pdf-to-md、convert-word-to-md 同一提交加入，经同一套 PR 审查流程。 ⑥ License——MIT（仓库级），明确。 ⑦ 最近维护——最近一次内容改动距今约一个月，在半年维护窗口内。
综合评分 = (7+8+9)/3 = 8.0
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| xlsx（Anthropic 官方 skill） | 通用 Excel 工具箱：创建、编辑、公式重算校验、格式化，强制用公式而非硬编码数值 | 定位是“生成/编辑”表格，本技能定位是“读取已有表格供分析”；本技能更轻量（仅需一次 pip 安装），且专门处理嵌入图片按 sheet 归类 |
| minimax-xlsx | 用 XML 直接操作替代 openpyxl 往返编辑，保留复杂 Excel 文件的格式与结构不被破坏 | 同样是“编辑既有表格”方向，服务对象是要修改并保存回 xlsx 的场景；本技能只单向转出为 Markdown 供 agent 阅读，不回写原文件 |
| anydoc | 一条命令零安装，覆盖 Word/PPT/Excel/PDF 等 20 余种格式转 Markdown | 格式覆盖面远大于本技能（仅 Excel）；本技能在 Excel 场景下额外做按 sheet 归类的真实图片提取，并明确排除图表对象这一容易混淆的边界 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。仓库官方展示页面（awesome-copilot.github.com）提供功能与安装说明，未展示安装量或评分类数据。
9. 安装使用方式
渠道一（GitHub CLI，推荐）：
gh skills install github/awesome-copilot convert-excel-to-md渠道二（手动复制）：将仓库 skills/convert-excel-to-md/ 整个目录（含 SKILL.md、scripts/、references/）复制到本地 agent 的 skills 目录下。
安装后注意：首次使用前需执行一次性环境准备（同一环境只需做一次，不必每次转换都做）：
python -m pip install -r scripts/requirements.txt无需重启 agent；环境准备好之后，agent 下次识别到 .xlsx 文件即会自动触发转换。
10. 注意事项
- 仅支持
.xlsx；不支持旧版.xls，需先在 Excel 中另存为.xlsx格式。 - Excel 原生图表对象不会被导出为图片，只有真正的嵌入图片（如插入的图标、照片）才会被提取——需要图表数据的用户应改为直接读取转出后的表格数值。
- 图片按 sheet 归类（而非精确单元格位置），是 MarkItDown 稳定锚点能达到的最细粒度。
- 需要本地 Python 3.10+ 环境并完成一次性 pip 依赖安装；纯托管、无法执行 pip 安装的受限沙箱环境可能无法使用。
- 跨 Agent 兼容性目前仅确认 Claude Code / Codex 基于同一开放格式原生支持，OpenClaw 与 Hermes Agent 尚未实机验证。