md-to-docx-skill

一个强大的 Markdown 转 Word 文档转换器 Agent Skill，能够将 Markdown 文件自动转换为专业格式的 Word 文档（.docx）。

Samples

📌 何时调用

在以下情况下调用此 Skill：

• ✅ 用户想要将 Markdown 文件转换为 Word 文档
• ✅ 用户要求从 Markdown 内容创建 Word 文档
• ✅ 用户提及 .md 到 .docx 的转换
• ✅ 用户需要格式化的文档输出

🔄 处理流程

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   输入 MD 文件   │ ──▶ │  版本号管理处理  │ ──▶ │  格式规范化处理  │ ──▶ │   解析 MD 元素   │ ──▶ │  生成 Word 文档  │
└─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘
                                                      │
                                            ┌─────────┴─────────┐
                                            ▼                   ▼
                                      ┌───────────┐       ┌───────────┐
                                      │ 保存规范化 │       │ 应用模板   │
                                      │ 后的文件   │       │ 样式       │
                                      └───────────┘       └───────────┘

✨ 核心特性

🔄 自动版本管理

• 智能识别文件名中的版本号并自动递增
• 支持扫描目录中已有版本并自动编号
• 统一管理 .docx 和 _normalized.md 文件的版本号

🛠️ Markdown 格式规范化

自动修复常见的 Markdown 格式问题：

📝 完整的 Markdown 支持

🎨 专业文档格式

• 符合中文文档规范的字体和字号设置
• 智能段落排版（首行缩进、行间距）
• 标题自动分页控制
• 表格样式美化
• 代码块高亮显示
• 可选封面页生成

📦 安装依赖

pip install python-docx

🚀 使用方法

基本转换

将此 Markdown 文件转换为 Word：
[提供 .md 文件路径或内容]

使用自定义模板

使用此模板将 Markdown 转换为 Word：
Markdown：[路径或内容]
模板：[.docx 模板路径]

带封面页

转换为带封面页的 Word：
[Markdown 内容]
标题：[文档标题]
版本：[版本号]
日期：[日期]

参数说明

📁 项目结构

md-to-docx-skill/
├── skill/
│   └── SKILL.md              # Skill 详细说明文档
├── md_to_docx.py             # 主转换脚本
├── markdown_normalizer.py    # Markdown 格式规范化
├── version_manager.py        # 自动版本编号
├── create_template.py        # 模板生成脚本（可选）
└── template.docx             # 默认 Word 模板（可选）

📋 输出文件

转换后，生成以下文件：

版本号示例：

• 首次转换：document_V1.docx、document_V1_normalized.md
• 第二次转换：document_V2.docx、document_V2_normalized.md
• 带版本输入：document_V3.md → document_V4.docx

🎯 文档格式规范

字体规范

段落规范

标题规范

表格规范

代码块规范

行内代码规范

引用块规范

列表规范

分隔线规范

封面页规范

分页控制

💡 使用场景

• 📄 技术文档转换为正式 Word 文档
• 📋 项目报告自动化生成
• 📝 会议纪要格式化输出
• 📚 知识库文档标准化
• 📖 书籍章节排版

🔧 高级功能

格式规范化示例

输入（含问题）：

# 测试文档
## 一、表格测试
| 列1|列2|列3
|数据1|数据2|数据3
###标题无空格
-项目1无空格

规范化输出：

# 测试文档

## 1. 表格测试

|列1|列2|列3|
|---|---|---|
|数据1|数据2|数据3|

### 标题无空格

- 项目1无空格

版本号管理

🎨 模板支持

使用自定义模板

如果提供了模板：

• 继承页面设置（边距、纸张大小）
• 继承样式定义（标题 1-6、正文）
• 添加新内容前清除模板内容

内置样式（无模板）

本 Skill 可独立运行，无需外部模板文件。

如果未提供模板或模板文件不存在：

• 自动创建空白文档
• 使用默认页面设置（A4，2.54cm 边距）
• 以编程方式创建样式
• 应用一致的格式

这意味着本 Skill 可以在任何安装了 Python 和 python-docx 的环境中独立运行，无需依赖外部模板文件。

📖 详细文档

查看 SKILL.md 获取完整的功能说明、参数配置和实现细节。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🙏 致谢

本项目基于 python-docx 库开发。