Markdown To Word Skill — Markdown To Word 技能

Markdown转Word技能 描述

使用Python的python-docx、markdown、beautifulsoup4库将Markdown文件转换为格式良好的Word文档。支持标题、段落、列表、表格、代码块、图片等Markdown元素的转换。

激活条件

当用户需要将Markdown文件转换为Word文档时激活此技能。

技能目录结构 markdown-to-word-技能/ ├── 技能.md # 技能定义文件 ├── README.md # 详细文档 ├── requirements.txt # Python依赖 ├── 安装.sh # 安装脚本 ├── quick_启动.sh # 快速开始脚本 ├── scripts/ │ ├── md2docx.py # 主转换脚本 │ ├── md2docx_batch.py # 批量转换脚本 │ ├── md2docx_with_images.py # 带图片转换脚本 │ └── template_处理器.py # 模板处理器 ├── templates/ │ ├── academic.docx # 学术论文模板 │ ├── business.docx # 商业报告模板 │ └── technical.docx # 技术文档模板 ├── examples/ │ ├── sample.md # 示例Markdown文件 │ ├── sample_输出.docx # 示例输出 │ └── test_images/ # 测试图片目录 └── config/ └── styles.json # 样式配置

核心功能

• 基础转换

将Markdown文件转换为Word文档 支持所有基本Markdown语法 保持文档结构和格式

• 高级功能

图片处理：自动插入图片并调整大小 表格转换：将Markdown表格转换为Word表格 代码块：保留代码格式和语法高亮 数学公式：支持LaTeX数学公式 自定义样式：应用预定义或自定义样式

• 批量处理

批量转换多个Markdown文件 支持文件夹递归处理 生成进度报告

• 模板系统

使用预定义模板（学术、商业、技术） 自定义模板支持 自动应用样式 依赖安装 Python依赖 pip 安装 python-docx markdown beautifulsoup4 pillow

系统依赖（可选） # Ubuntu/Debian sudo apt-获取 安装 python3-pip python3-venv

# macOS brew 安装 python3

使用方法

• 基本转换

python scripts/md2docx.py --输入 sample.md --输出 sample.docx

• 使用模板

python scripts/md2docx.py --输入 sample.md --输出 sample.docx --template templates/academic.docx

• 批量转换

python scripts/md2docx_batch.py --输入-dir ./markdown_files --输出-dir ./word_docs

• 带图片转换

python scripts/md2docx_with_images.py --输入 sample.md --输出 sample.docx --image-dir ./images

脚本说明 md2docx.py - 主转换脚本 """ Markdown转Word主转换脚本 支持：

• 标题（H1-H6）
• 段落和文本格式（粗体、斜体、删除线）
• 列表（有序、无序）
• 表格
• 代码块
• 引用块
• 水平线
• 图片
• 链接

"""

# 基本用法 python md2docx.py --输入 输入.md --输出 输出.docx

# 高级选项 python md2docx.py --输入 输入.md --输出 输出.docx \ --template academic.docx \ --style-title "Title" \ --style-heading1 "Heading 1" \ --style-heading2 "Heading 2" \ --style-paragraph "Normal" \ --style-code "Code" \ --style-quote "Quote"

md2docx_batch.py - 批量转换脚本 """ 批量转换脚本 支持：

• 批量处理文件夹中的所有Markdown文件
• 递归处理子文件夹
• 保持目录结构
• 生成转换报告

"""

# 基本用法 python md2docx_batch.py --输入-dir ./docs --输出-dir ./word_docs

# 高级选项 python md2docx_batch.py --输入-dir ./docs --输出-dir ./word_docs \ --recursive \ --template technical.docx \ --报告 报告.json \ --skip-existing

md2docx_with_images.py - 带图片转换脚本 """ 带图片处理的转换脚本 支持：

• 自动查找并插入图片
• 图片大小调整
• 图片居中/对齐
• 图片标题
• 相对路径支持

"""

# 基本用法 python md2docx_with_images.py --输入 article.md --输出 article.docx --image-dir ./images

# 高级选项 python md2docx_with_images.py --输入 article.md --输出 article.docx \ --image-dir ./images \ --image-width 500 \ --image-height 300 \ --image-质量 85 \ --添加-captions

支持的Markdown元素

• 标题

# 一级标题

二级标题

三级标题

• 文本格式

粗体文本 斜体文本 ~~删除线文本~~

• 列表
• 无序列表项1
• 无序列表项2

• 有序列表项1
• 有序列表项2

• 表格

列1	列2	列3
数据1	数据2	数据3
数据4	数据5	数据6

• 代码块

def hello_world():
    print("Hello, World!")

• 图片

!图片描述

• 链接

链接文本

• 引用

这是一段引用文字
可以有多行

• 水平线

---

样式配置 默认样式映射 { "h1": "Heading 1", "h2": "Heading 2", "h3": "Heading 3", "h4": "Heading 4", "h5": "Heading 5", "h6": "Heading 6", "p": "Normal", "code": "Code", "quote": "Quote", "table": "Table Grid", "image": "Image Caption" }

自定义样式

创建 config/styles.json：

{ "styles": { "title": "自定义标题", "heading1": "自定义标题1", "heading2": "自定义标题2", "paragraph": "自定义段落", "code": "代码样式", "quote": "引用样式" }, "font": { "title": {"name": "微软雅黑", "size": 24, "bold": true}, "heading1": {"name": "微软雅黑", "size": 18, "bold": true}, "paragraph": {"name": "宋体", "size": 12} }, "colors": { "title": "2E74B5", "heading1": "2E74B5", "code_background": "F2F2F2" } }

模板系统 预定义模板

academic.docx - 学术论文模板

符合学术论文格式 包含摘要、关键词、参考文献 支持章节编号

business.docx - 商业报告模板

专业商业风格 包含公司记录o、页眉页脚 图表和表格样式

technical.docx - 技术文档模板

代码友好格式 技术图表支持 API文档样式 创建自定义模板 在Word中创建模板文档 定义样式（标题、段落、代码等） 保存为 .docx 文件到 templates/ 目录 使用 --template 参数指定 安装脚本 安装.sh #!/bin/bash # Markdown转Word技能安装脚本

echo "安装Markdown转Word技能..."

# 创建虚拟环境 python3 -m venv venv source venv/bin/activate

# 安装Python依赖 pip 安装 python-docx markdown beautifulsoup4 pillow

# 创建必要目录 mkdir -p templates examples test_images config

echo "✅ 安装完成！" echo "激活虚拟环境：source venv/bin/activate" echo "运行测试：python scripts/md2docx.py --输入 examples/sample.md --输出 examples/sample_输出.docx"

quick_启动.sh #!/bin/bash # 快速开始脚本

echo "Markdown转Word技能快速开始..."

# 检查虚拟环境 if [ ! -d "venv" ]; then echo "创建虚拟环境..." python3 -m venv venv fi

# 激活虚拟环境 source venv/bin/activate

# 安装依赖 pip 安装 -q python-docx markdown beautifulsoup4 pillow

# 运行示例 echo "运行示例转换..." python scripts/md2docx.py --输入