核心用法
md2word-cn 是一款面向中文用户的 Markdown 转 Word 文档转换工具,由开发者荣彧(rongyu)维护。其核心使用方式为命令行调用 Python 脚本:
python3 <skill>/scripts/md2word.py <输入.md> <输出.docx>
安装依赖仅需 pip3 install python-docx,门槛低、配置简单。
显著优点
1. 中文排版优化:强制使用仿宋字体,严格遵循中文公文/报告的视觉规范,各级标题字号分级明确(22pt/16pt/14pt/12pt),一级标题自动居中,省去手动调整格式的繁琐。
2. 语法覆盖完整:支持标题层级、加粗/斜体/删除线、行内代码与代码块、链接、有序/无序列表、引用、水平分割线等全部常用 Markdown 语法,满足日常办公文档的复杂排版需求。
3. 细节处理周到:有序列表采用手动编号机制,规避 Word 原生自动编号易出现的重复编号 bug;代码块预设灰色背景;链接自动添加下划线,导出后无需二次编辑。
4. 场景适配精准:针对周报、日报、报告等高频中文办公场景优化,输出文档可直接用于邮件附件、打印提交或协同审阅。
潜在缺点与局限性
- 字体绑定单一:强制仿宋字体,若用户所在机构要求使用宋体、楷体等其他公文字体,需手动修改源码,缺乏配置灵活性。
- 依赖外部库:需预先安装
python-docx,在离线环境或受限权限的服务器上部署可能受阻。 - 交互方式局限:纯命令行操作,无 GUI 界面,对非技术背景的办公人员不够友好。
- 平台限制:基于 Python 与 python-docx,Windows/macOS/Linux 均可运行,但未提供预编译二进制文件,需保证 Python 环境可用。
适合人群
- 技术团队、运维人员需快速生成标准化中文周报/日报
- 研究人员、分析师需将 Markdown 笔记转为正式 Word 报告
- 政府机关、国企员工需符合仿宋公文格式要求的文档输出
常规风险
- 文档兼容性:不同版本 Word 对 python-docx 生成文档的渲染可能存在细微差异,建议转换后在目标 Word 版本中预览确认。
- 图片与表格:当前语法表未提及图片插入、复杂表格支持,若 Markdown 包含此类元素可能丢失或需后续手动调整。
- 安全性:脚本执行涉及文件 I/O 操作,建议审查来源代码确认无恶意行为后再部署于生产环境。