33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
---
|
|
name: xlsx-to-md
|
|
description: 将 Excel .xlsx 工作簿转换为 Markdown，按工作表提取表格、公式或缓存值，并处理合并单元格和空工作表。适用于需要可读文本版本的现代 Excel 文件；旧版 .xls、宏、图表或公式重算不应触发本 Skill。
|
|
---
|
|
|
|
# Excel 转 Markdown
|
|
|
|
使用 `scripts/convert.py` 将 `.xlsx` 工作簿转换为单个 Markdown 文件，每个工作表形成独立章节。
|
|
|
|
## 执行边界
|
|
|
|
- 只接受 `.xlsx`，不把 `.xls` 伪装成受支持格式。
|
|
- 默认保留公式文本；只有用户希望读取工作簿内已有缓存值时才使用 `--values`。转换器不会计算公式。
|
|
- 合并单元格默认将锚点值填充到合并区域，可用 `--merged anchor` 仅保留左上角值。
|
|
- 默认在输入文件旁生成同名 `.md`，已存在时停止；覆盖必须获得用户确认并传入 `--force`。
|
|
- 不提取宏、图表、批注、数据验证、条件格式或图片，也不自动安装依赖。
|
|
|
|
## 工作流
|
|
|
|
1. 确认公式模式、合并单元格策略和输出路径。
|
|
2. 使用工作区依赖运行时执行：
|
|
|
|
```text
|
|
python scripts/convert.py <input.xlsx> [--output <file.md>] [--values] [--merged fill|anchor] [--force]
|
|
```
|
|
|
|
3. 抽查工作表数量、标题、边界行列、公式和转义字符。
|
|
4. 报告空工作表、公式缓存为空及未迁移对象等警告。
|
|
|
|
## 语义说明
|
|
|
|
Markdown 只能表达二维文本表格。日期以 ISO 可读格式输出，单元格换行转换为 `<br>`，竖线会转义。数字显示可能与 Excel 自定义格式不同；需要报表级显示保真时应使用电子表格工具直接查看源文件。
|