用途:在本地命令行中转换常见文档与数据格式,尽量保留源格式允许的结构。
主要能力与转换矩阵:Markdown↔HTML、HTML→Markdown、HTML→纯文本、CSV↔JSON、JSON→CSV(嵌套对象用点号扁平化)、CSV↔Markdown 管道表格、YAML↔JSON、YAML↔TOML、TOML↔JSON/TOML、XLSX→CSV(仅首个工作表)、Markdown→PDF。核心转换使用 Python 标准库(json、csv、HTML 解析、Markdown 启发式、tomllib 及自定义 TOML/YAML 写入器)。
使用方式:从技能目录运行脚本,例如:python scripts/convert.py --input notes.md --from markdown --to html --output notes.html。省略 --from 时按输入文件扩展名自动检测;文本格式省略 --output 时输出到 stdout。
依赖:Markdown→PDF 需 pandoc;Excel→CSV 需 openpyxl(python -m pip install openpyxl)。缺失时 CLI 给出安装提示并以非零码退出。
限制:CSV 无类型与嵌套,JSON→CSV 不可逆,往返会丢失数字/布尔/日期类型;HTML 转换丢弃 CSS、脚本、复杂布局;无 PyYAML 时仅支持基础 YAML,不支持锚点、别名、标签、流式、合并键与多文档;TOML 输出拒绝混合数组、表数组等;仅读取 XLSX 首个工作表;不提供 OCR、PDF 文本提取和 Office 编辑;Markdown→CSV 只读取首个管道表格并忽略周围正文。