Markdown to Word

Markdown转Word文档技能 概述

将 Markdown 文档转换为符合中文排版标准的 Word 文档。支持完整的 Markdown 语法，自动应用专业格式设置。

依赖要求 Python 依赖 pip 安装 python-docx Pillow beautifulsoup4 PyYAML

可选依赖 npm 安装 -g @mermAId-js/mermAId-命令行工具

快速开始

主转换脚本：scripts/md2word.py

# 基本转换 python scripts/md2word.py 输入.md 输出.docx

# 使用预设格式 python scripts/md2word.py 输入.md --pre设置=academic

# 使用自定义配置 python scripts/md2word.py 输入.md --config=my-config.yaml

配置系统 内置预设

预设信息从 YAML 文件动态读取，运行以下命令查看完整列表：

python scripts/config.py --列出

常用预设：

legal — 法律文书格式（默认） 服务-plan — 法律服务方案（含分层配色） minimal — 极简格式 academic — 学术论文格式 报告 — 工作报告格式

完整配置见 as设置s/pre设置s/*.yaml，设计说明见 as设置s/theme-notes/

自定义配置

复制配置模板并修改：

cp as设置s/config-template.yaml my-config.yaml

Word 模板文件

将 .docx 模板放入 as设置s/templates/ 目录，或使用 --template 指定。

Word 模板 vs 配置文件：

Word 模板：控制视觉元素（页眉、页脚、记录o） 配置文件：控制格式参数（字号、行距、页边距） 参考文档 配置参考: references/config-reference.md 样式映射: references/style-m应用ings.md 使用示例: references/examples.md 错误处理 文件编码：自动检测 UTF-8 和 GBK 模板找不到：使用默认格式创建新文档 MermAId 失败：降级为文本描述 图片过大：自动压缩和调整尺寸 目录结构 md2word/ ├── 技能.md # 本文档 ├── CHANGE记录.md # 版本记录 ├── references/ # 参考文档 │ ├── config-reference.md │ ├── style-m应用ings.md │ └── examples.md ├── scripts/ # 转换脚本 │ ├── md2word.py # 主脚本 │ ├── config.py # 配置模块（含 --列出 查看预设） │ ├── 提取_template_config.py # 从 Word 模板提取配置 │ ├── 格式化器.py # 文本格式化模块 │ ├── table_处理器.py # 表格处理模块 │ └── 图表_处理器.py # 图表渲染模块 └── as设置s/ # 资源文件 ├── pre设置s/ # YAML 预设配置 ├── theme-notes/ # 预设设计说明文档 ├── templates/ # Word 模板文件 └── config-template.yaml