SuperAPI AI 工具集

md2word

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:该技能用于将 Markdown 文档转换为符合中文排版标准的专业 Word 文档,适合正式文档、论文、报告等需要规范排版的转换需求,支持完整 Markdown 语法并自动应用专业格式设置。

主要能力:内置多种预设格式,包括 legal(法律文书,默认)、service-plan(法律服务方案,含分层配色)、minimal(极简)、academic(学术论文)、report(工作报告);预设信息从 YAML 文件动态读取,可用 python scripts/config.py --list 查看完整列表。配置分为两类:Word 模板控制视觉元素(页眉、页脚、Logo),配置文件控制格式参数(字号、行距、页边距)。

使用方式:安装依赖 pip install python-docx Pillow beautifulsoup4 PyYAML;可选依赖 npm install -g @mermaid-js/mermaid-cli。主脚本为 scripts/md2word.py。基本转换:python scripts/md2word.py input.md output.docx;使用预设格式:python scripts/md2word.py input.md --preset=academic;使用自定义配置:python scripts/md2word.py input.md --config=my-config.yaml。可复制模板 cp assets/config-template.yaml my-config.yaml 进行自定义;.docx 模板放入 assets/templates/ 目录或用 --template 指定。

错误处理:自动检测 UTF-8 和 GBK 文件编码;模板找不到时使用默认格式创建新文档;Mermaid 失败时降级为文本描述;图片过大时自动压缩和调整尺寸。

参考文档:配置参考 references/config-reference.md、样式映射 references/style-mappings.md、使用示例 references/examples.md。

限制:需先安装上述 Python 依赖;Mermaid 图表渲染需额外安装可选依赖,未安装时图表将降级为文本描述;其他具体限制暂未提供。