📄 TOword - Markdown 转 Word 转换器

一个简单易用的 Markdown (.md) 转 Word (.docx) 转换工具，支持可视化拖拽操作，一键将 Markdown 文件转换为格式优美的 Word 文档。

✨ 功能特性

• 🖱️ 拖拽支持：直接将 .md 文件拖拽到窗口即可转换
• 📝 完整格式支持：
  • 标题（H1-H6）
  • 粗体、斜体、粗斜体、删除线
  • 行内代码、代码块
  • 无序列表、有序列表
  • 块引用
  • 水平分隔线
  • 链接、图片
• 📁 智能输出：默认保存到桌面，避免同名文件混淆
• 🚀 一键转换：转换完成后可自动打开生成的 docx 文件
• 🎨 美观排版：中文字体优化，代码块灰底高亮

📦 安装与使用

方式一：直接下载 Release 包（推荐普通用户）

1. 前往本项目的 Releases 页面
2. 下载最新版本的压缩包（.zip）
3. 解压后运行 启动转换器.bat 即可

方式二：从源码运行（推荐开发者）

环境要求

• Python 3.8+
• Windows 操作系统（拖拽功能依赖 Windows API）

安装步骤

# 1. 克隆仓库
git clone https://github.com/你的用户名/TOword.git
cd TOword

# 2. 创建虚拟环境（可选但推荐）
python -m venv .venv
.venv\Scripts\activate

# 3. 安装依赖
pip install -r requirements.txt

# 4. 运行 GUI 版本
python md_to_docx_gui.py

命令行使用

也支持命令行方式转换：

python md_to_docx.py 输入文件.md [输出文件.docx]

如果省略输出文件名，将自动使用输入文件名（仅替换扩展名为 .docx）。

📖 使用说明

GUI 界面操作

1. 运行 启动转换器.bat 或执行 python md_to_docx_gui.py
2. 将 .md 文件拖拽到窗口中，或点击选择文件
3. （可选）点击"自定义路径"修改输出位置
4. 点击"🚀 开始转换"按钮
5. 转换完成后，文件将自动打开（或提示打开所在文件夹）

📁 项目结构

TOword/
├── md_to_docx.py          # 核心转换引擎
├── md_to_docx_gui.py      # GUI 界面
├── 启动转换器.bat          # Windows 启动脚本
├── requirements.txt       # Python 依赖
├── test_sample.md         # 测试用 Markdown 文件
├── .gitignore
├── LICENSE
└── README.md

🔧 技术栈

• Python - 编程语言
• python-docx - Word 文档生成
• windnd / tkinterdnd2 - 拖拽功能支持
• tkinter - GUI 界面
• Pillow - 图片处理

📝 许可证

本项目基于 MIT License 开源。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request