Markdown to DOCX 转换工具

一个功能强大的 Markdown 转 DOCX 文档转换工具，支持丰富的 Markdown 语法，提供命令行和批量转换功能，能够生成格式精美的 DOCX 文档。

特性

• 支持标准 Markdown 语法
• 完整的格式转换（标题、列表、代码块、表格、引用、图片等）
• 批量转换功能
• 命令行接口
• 本地处理，保护隐私

已实现功能

• ✅ 标题转换（h1-h6）
• ✅ 段落和文本样式（粗体、斜体、删除线）
• ✅ 引用块（支持多层嵌套）
• ✅ 列表转换（有序列表、无序列表、多级嵌套）
• ✅ 代码块（支持语法高亮）
• ✅ 链接处理（内联链接、引用链接、URL自动链接）
• ✅ 图片支持（本地图片、在线图片）
• ✅ 表格转换（基础表格、对齐方式）
• ✅ 分隔线
• ✅ 任务列表（TODO列表）
• ✅ 基础HTML标签支持

TODO

• 🔲 图形用户界面
• 🔲 实时预览功能
• 🔲 自定义样式配置
• 🔲 数学公式支持
• 🔲 流程图支持
• 🔲 双向转换（Word转回Markdown）
• 🔲 插件系统

开发环境要求

• Python 3.8+
• python-docx
• markdown-it-py
• 其他依赖见 requirements.txt

安装

1. 克隆仓库：

git clone [repository-url]
cd md2docx

2. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows

3. 安装依赖：

pip install -r requirements.txt

使用方法

单文件转换

python -m src.cli input.md output.docx

批量转换

python batch_convert_test.py --input-dir your_md_folder --output-dir your_docx_folder

项目结构

md2docx/
├── src/                    # 源代码
│   ├── converter/         # 转换核心
│   │   ├── base.py       # 基础转换类
│   │   ├── elements/     # 各类元素转换器
│   │       ├── base.py   # 基础元素转换器
│   │       ├── text.py   # 文本相关（段落、样式）
│   │       ├── heading.py # 标题转换
│   │       ├── list.py   # 列表转换
│   │       ├── code.py   # 代码块转换
│   │       ├── table.py  # 表格转换
│   │       ├── image.py  # 图片转换
│   │       ├── links.py  # 链接转换
│   │       ├── blockquote.py # 引用块转换
│   │       ├── hr.py     # 分隔线转换
│   │       ├── task_list.py # 任务列表转换
│   │       └── html.py   # HTML标签转换
│   └── cli.py          # 命令行接口
├── tests/               # 测试用例
│   ├── unit/           # 单元测试
│   ├── integration/    # 集成测试
│   └── samples/        # 测试样例
│       ├── basic/      # 基础语法样例
│       └── advanced/   # 高级语法样例
├── docs/               # 文档
├── batch_convert_test.py # 批量转换脚本
├── requirements.txt    # 项目依赖
└── README.md          # 项目说明

开发指南

请参考 docs/architecture.md 了解详细的架构设计和开发规范。

测试

运行测试：

pytest tests/

贡献指南

1. Fork 项目
2. 创建特性分支
3. 提交变更
4. 推送到分支
5. 创建 Pull Request

许可证

MIT License