CraftKit/plugins/doc/skills/xlsx-to-md/SKILL.md

name, description

name	description
xlsx-to-md	将 Excel .xlsx 工作簿转换为 Markdown，按工作表提取表格、公式或缓存值，并处理合并单元格和空工作表。适用于需要可读文本版本的现代 Excel 文件；旧版 .xls、宏、图表或公式重算不应触发本 Skill。

Excel 转 Markdown

使用 scripts/convert.py 将 .xlsx 工作簿转换为单个 Markdown 文件，每个工作表形成独立章节。

执行边界

• 只接受 .xlsx，不把 .xls 伪装成受支持格式。
• 默认保留公式文本；只有用户希望读取工作簿内已有缓存值时才使用 --values。转换器不会计算公式。
• 合并单元格默认将锚点值填充到合并区域，可用 --merged anchor 仅保留左上角值。
• 默认在输入文件旁生成同名 .md，已存在时停止；覆盖必须获得用户确认并传入 --force。
• 不提取宏、图表、批注、数据验证、条件格式或图片，也不自动安装依赖。

工作流

1. 确认公式模式、合并单元格策略和输出路径。

2. 使用工作区依赖运行时执行：

   python scripts/convert.py <input.xlsx> [--output <file.md>] [--values] [--merged fill|anchor] [--force]
   

3. 抽查工作表数量、标题、边界行列、公式和转义字符。

4. 报告空工作表、公式缓存为空及未迁移对象等警告。

语义说明

Markdown 只能表达二维文本表格。日期以 ISO 可读格式输出，单元格换行转换为 <br>，竖线会转义。数字显示可能与 Excel 自定义格式不同；需要报表级显示保真时应使用电子表格工具直接查看源文件。