About excel-to-markdown
A skill for converting Excel workbooks in .xlsx or .xlsm format into Markdown tables. It is intended for preparing spreadsheets such as project specifications for reading or use as development context.
Key features
- 01Convert Excel files to Markdown
- 02Choose merged-cell handling mode
- 03Enable verbose logs
Use cases
- 01Preparing specification sheets for reading
- 02Providing spreadsheet content as development context
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ sakumyz/ skills --skill excel-to-markdownAfter installing, type/excel-to-markdownin Claude Code to confirm it loaded.
Bundled filesscripts/excel_to_markdown_general.py
Details
From the project READMEExcel 转 Markdown
任务目标
将 Excel 文件(.xlsx/.xlsm)转换为合法的 Markdown 表格格式,用于式样书阅读、上下文提供等场景。
前置依赖
openpyxl>=3.0.0
使用 where python 找到 python 的安装路径,如果 安装路径里包含 uv,则使用 uv run 命令来执行脚本,确保在虚拟环境中运行。如果无法找到 python,可以提示用户安装 python 或者使用虚拟环境,然后结束程序。
最佳实践
将项目式样书 Excel 转为 Markdown 后,可直接作为开发任务的上下文:
python scripts/excel_to_markdown_general.py ./式様書.xlsx -o ./式様書.md
如用户没有其他特殊需求,执行上面格式的命令即可,如果有更具体的要求,再看下面的【其他参数】部分。
其他参数
基本转换
python scripts/excel_to_markdown_general.py <excel文件> [-o <md文件>]
合并单元格处理模式
python scripts/excel_to_markdown_general.py <excel文件> --merge-mode tl
tl(默认):仅在合并区域左上角保留值fill:将左上角值填充到合并区域每个子单元格
输出详细日志
python scripts/excel_to_markdown_general.py <excel文件> --verbose
资源索引
Comments
Markdown supported