# word2md

**Repository Path**: thomascatlee/word2md

## Basic Information

- **Project Name**: word2md
- **Description**: docx和md格式的转换
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-01
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Markdown转Word转换工具 (md2docx.py)

这是一个将Markdown文件转换为Word文档(.docx)的Python工具，特别支持表格转换。

## 功能特性

- ✅ **表格转换**: 支持Markdown表格到Word表格的完整转换
- ✅ **标题转换**: 支持1-6级标题转换
- ✅ **列表转换**: 支持有序列表和无序列表
- ✅ **文本格式**: 支持粗体、斜体、行内代码
- ✅ **代码块**: 支持代码块转换，使用等宽字体
- ✅ **图片插入**: 支持图片嵌入语法转换
- ✅ **水平线**: 支持分隔线转换
- ✅ **中文支持**: 完全支持中文字符，默认使用宋体

## 安装依赖

```bash
pip install python-docx
```

## 使用方法

### 基本用法

```bash
python md2docx.py input.md
```

这将在同目录下生成 `input.docx` 文件。

### 指定输出文件

```bash
python md2docx.py input.md output.docx
```

### 批量转换脚本

```python
from md2docx import MarkdownConverter
import glob

converter = MarkdownConverter()
for md_file in glob.glob("*.md"):
    converter.convert_file(md_file)
```

## 支持的Markdown语法

### 表格

```markdown
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
```

**转换效果**:
- 自动创建Word表格
- 表头自动加粗
- 表格居中对齐

### 标题

```markdown
# 一级标题
## 二级标题
### 三级标题
```

### 列表

```markdown
- 无序列表项1
- 无序列表项2

1. 有序列表项1
2. 有序列表项2
```

### 文本格式

```markdown
这是**粗体文本**
这是*斜体文本*
这是`行内代码`
```

### 代码块

```python
def hello():
    print("Hello World")
```

### 水平线

```markdown
---
***
```

## 代码结构

### MarkdownConverter 类

主要的转换器类，包含以下方法：

- `convert_file()`: 主转换方法
- `parse_markdown_table()`: 表格解析
- `parse_heading()`: 标题解析
- `parse_list()`: 列表解析
- `parse_code_block()`: 代码块解析
- `_process_inline_formatting()`: 行内格式处理

## 示例

输入文件 `example.md`:
```markdown
# 示例文档

## 用户信息表

| 姓名 | 年龄 | 邮箱 |
|------|------|------|
| 张三 | 25 | zhang@example.com |
| 李四 | 30 | li@example.com |

## 功能列表

- 支持表格转换
- 支持中文
- 支持各种格式

这是**重要**的功能。
```

运行命令:
```bash
python md2docx.py example.md
```

将生成 `example.docx` 文件，包含完整格式的表格和文本。

## 注意事项

1. **表格格式**: 表格行必须以 `|` 开头和结尾
2. **编码**: 支持UTF-8编码，完全兼容中文
3. **字体**: 中文默认使用宋体，代码使用Consolas
4. **兼容性**: 生成的Word文档兼容Microsoft Word 2007及以上版本

## 错误处理

常见错误及解决方法：

1. **FileNotFoundError**: 检查输入文件路径是否正确
2. **ImportError**: 确保已安装 `python-docx` 库
3. **编码错误**: 确保Markdown文件使用UTF-8编码

## 扩展功能

可以轻松扩展以支持更多Markdown特性：

- 链接转换
- 图片插入
- 引用块
- 任务列表
- 表格单元格格式（居中、颜色等）

## 版本信息

- 版本: 1.0
- Python要求: 3.6+
- 主要依赖: python-docx