SuperAPI AI 工具集

convert-excel-to-md

办公与效率

查看项目

更新于 10-16 08:47

技能介绍

用途:当遇到需要理解或处理的 .xlsx 文件时使用,例如用户附上电子表格并提问、要求总结数据、提取特定行或值,或批量处理同一文件夹中的多个工作簿。由于 .xlsx 本质是压缩的 XML 包,无法可靠地作为纯文本读取,应先用本技能转换为 Markdown,而非直接解析。

主要能力:基于 markitdown 将每个工作表渲染为独立的 ## <SheetName> Markdown 表格;额外提取真正嵌入的位图图片(非图表),按工作表映射到输出目录,图片位于表格之后、以“#### Images in this sheet”标题呈现。图片按表放置,非精确单元格位置,这是 MarkItDown 稳定输出所能达到的最细粒度。无嵌入图片时不生成 img/ 目录。原生 Excel 图表不会作为图片提取。

使用方式:安装脚本为 scripts/convert_excel_to_md.py,首次使用前参照 references/setup.md 安装 Python、pip 与 markitdown。单文件:python scripts\convert_excel_to_md.py "C:\path\to\workbook.xlsx";指定输出:加 -o "C:\path\to\output_folder";批量处理文件夹:传入文件夹路径,加 --recursive 包含子文件夹,加 -o 收集到统一父目录。默认输出到源文件旁,仅当用户明确指出路径时才用 -o;路径不完整时先确认完整绝对路径。转换后读取生成的 .md 文件执行实际分析。

适用场景与限制:仅支持 .xlsx,旧版 .xls 需用户先另存为 .xlsx。混合文件类型时,.pdf、.docx 需分别调用对应技能,不可静默跳过。常见故障包括未安装 markitdown(退出码 2)、不支持 .xls(退出码 3)、路径不存在(退出码 3)、个别文件损坏或加密(批量中报告失败但不影响其它文件)。收费、价格、平台等信息暂未提供。