前言¶

文档、需求清单、测试用例经常以 .xlsx 或 .xls 形式流转。要在仓库里留档、写技术说明，或让大模型基于表格内容继续处理，往往需要先把表结构变成 Markdown。手工复制粘贴容易丢格式、合并单元格也难对齐；自己写脚本则要处理格式差异和解析细节。下面介绍 SkillHub 上的社区 Skill excel-to-md，把「读表 → 解析 → 输出 Markdown」交给 Agent 按技能说明执行。

这是什么¶

excel-to-md 是面向办公效率（分类 office-efficiency）的 Agent Skill，坐标为 @user_d81eb31c/excel-to-md，版本 1.0.0，来源为 community，由发布者 user_d81eb31c 维护。

一句话定位：Excel 转 Markdown 工具，支持 .xlsx / .xls 文件读取、表格结构解析、单元格数据提取与 Markdown 输出。技能标签标明 requires_api_key=false，安装后一般不需要额外配置 API Key。

• 官方 API 入口：https://api.skillhub.cn/user_d81eb31c/excel-to-md
• SkillHub 页面：https://www.skillhub.cn/skills/user_d81eb31c/excel-to-md

核心功能¶

以下能力均来自 SkillHub 公开简介，未在资料中出现的细节（例如合并单元格、多 Sheet 策略、公式是否展开）本文不展开。

1. 格式支持：读取 .xlsx、.xls。
2. 结构解析：解析表格结构，便于还原为 Markdown 表格形态。
3. 数据提取：从单元格提取内容用于输出。
4. Markdown 输出：生成 Markdown 格式的表格文本，便于粘贴进文档或交给后续 Agent 任务。

触发词（在对话中提及即可引导 Agent 选用该 Skill）：excel转md、解析excel、表格转markdown、读excel文件。

安装与启用¶

Skill 基于通用 SKILL.md 格式。在 SkillHub 上安装时，官方给出的方式有两类：让 AI 按安装文档拉取，或用 skillhub CLI 指定安装目录。

方式一：通过 AI 安装¶

将下面提示发给当前使用的 AI 客户端（如 Cursor、Claude Code 等），由 Agent 按 SkillHub 安装说明完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d81eb31c/excel-to-md`。

方式二：skillhub CLI¶

若本机已有 skillhub，安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，可能不会被客户端识别。

先检查 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本 Skill 时，将坐标与目录替换为实际环境。以 Cursor 为例，常用 skills 路径为 ~/.cursor/skills/：

skillhub install user_d81eb31c/excel-to-md --dir ~/.cursor/skills/

其他客户端路径以 SkillHub 安装文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。安装或更新技能后，若客户端未自动加载，按各自产品说明重启或刷新技能列表。

典型用法¶

公开资料未附带独立命令行子工具说明，用法以「启用 Skill + 自然语言 + 本地文件」为主。

1. 确认 excel-to-md 已出现在当前 Agent 的 skills 目录中。
2. 在对话中说明目标，并带上触发词或明确意图，例如：使用 表格转markdown，把工作区内的某个 .xlsx 转成 Markdown 表格。
3. 提供或可访问的 Excel 文件路径，由 Agent 按 SKILL.md 中的流程读取、解析并输出 Markdown。

输出结果宜由你本地打开 Excel 对照抽查行列与关键单元格，尤其在表头复杂或存在空行空列时。

适用场景与注意¶

适合谁

• 需要把 Excel 表快速变成 Markdown，用于 README、设计文档、Issue 或知识库。
• 希望在 Cursor 等 IDE 里用对话完成转换，而不是每次写一次性脚本。

使用注意

• 社区来源（community），行为以安装包内 SKILL.md 为准；大表、多工作表、特殊格式是否完全支持，需在真实文件上验证。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 902；无需 API Key，但仍须遵守本地文件权限与数据合规要求。
• 转换结果是文本表格，不替代 Excel 中的公式计算、图表或复杂样式；若下游要机器可读结构化数据，可能仍需 CSV/JSON 等格式。

结尾¶

excel-to-md 把 Excel 读取、表结构解析和 Markdown 输出封装成 Agent Skill，配合触发词即可在对话里完成常见的「表格转文档」步骤。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_d81eb31c/excel-to-md 。