用途:当用户需要把 Markdown 文件转成 Word 文档时激活此技能,用 Python 脚本完成格式转换并保持文档结构。
主要能力:支持 H1–H6 标题、段落与粗体/斜体/删除线、有序与无序列表、表格、代码块、引用块、水平线、图片和链接的转换。图片可自动查找插入并调整尺寸、居中、添加标题,支持相对路径;表格转为 Word 表格;代码块保留格式;声称支持 LaTeX 数学公式;可应用预定义或自定义样式。提供三种预定义模板:academic.docx、business.docx、technical.docx,也支持把自定义 .docx 放入 templates/ 并通过 --template 指定。支持批量转换文件夹(含递归、保持目录结构、生成报告、跳过已存在)。
使用方式:先安装依赖 pip install python-docx markdown beautifulsoup4 pillow,可运行 install.sh 创建 venv。基本转换:python scripts/md2docx.py --input sample.md --output sample.docx;带模板转换加 --template templates/academic.docx;批量转换:python scripts/md2docx_batch.py --input-dir ./markdown_files --output-dir ./word_docs;带图片转换:python scripts/md2docx_with_images.py --input sample.md --output sample.docx --image-dir ./images。脚本还提供 --style-title、--style-heading1、--encoding、--debug 等选项。样式可在 config/styles.json 中配置标题、段落、代码、字体与颜色映射。
适用场景:把 Markdown 笔记、技术文档、报告、论文草稿整理成可交付的 Word 文件,或批量处理文档目录。
限制:实际转换效果依赖本地 Python 环境与 Word 模板中的样式定义;图片需存在且路径可解析;部分高级能力(如数学公式转换、自定义转换器、插件、Web API、多进程优化等)在资料中仅有描述性说明,未提供完整实现细节或验证结果;技能创建时间与作者等信息属资料自带内容。