用途:把 Excel 文件(.xlsx/.xlsm)转换为合法的 Markdown 表格,用于式样书阅读、为开发任务提供上下文等场景。
前置依赖:openpyxl>=3.0.0。使用 where python 找到 Python 安装路径;若路径中包含 uv,则用 uv run 执行脚本以确保在虚拟环境中运行。若找不到 Python,可提示用户安装 Python 或使用虚拟环境,然后结束程序。
主要能力:合并单元格处理、多工作表输出、基础字体语义(粗体/斜体)与超链接转换。
使用方式:核心脚本为 scripts/excel_to_markdown_general.py。基本转换:python scripts/excel_to_markdown_general.py <excel文件> [-o <md文件>]。推荐的无特殊需求命令:python scripts/excel_to_markdown_general.py ./式様書.xlsx -o ./式様書.md。合并单元格处理模式:python scripts/excel_to_markdown_general.py <excel文件> --merge-mode tl,其中 tl(默认)仅在合并区域左上角保留值,fill 将左上角值填充到合并区域每个子单元格。输出详细日志:python scripts/excel_to_markdown_general.py <excel文件> --verbose。
适用场景:将项目式样书 Excel 转为 Markdown 后直接作为开发任务上下文,或把数据表转为可读 Markdown 文档。
限制:资料未提供超出上述范围的功能、性能、收费或平台信息,暂未提供。