md2word

星标542

分支75

更新时间2026年7月23日 06:35

Markdown转Word文档技能。将Markdown文档转换为符合中文排版标准的专业格式Word文档，支持多种预设格式。适用于正式文档、论文、报告等需要规范排版的文档转换。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

cat-xierluo

cat-xierluo/legal-skills

打开 GitHub 仓库查看创作者相关仓库

下载

Markdown转Word文档Skill

概述

将 Markdown 文档转换为符合中文排版标准的 Word 文档。支持完整的 Markdown 语法，自动应用专业格式设置。

依赖要求

Python 依赖

pip install python-docx Pillow beautifulsoup4 PyYAML

可选依赖

npm install -g @mermaid-js/mermaid-cli   # Mermaid 图表渲染
brew install librsvg                       # SVG→PNG（推荐，rsvg-convert）
# 或 pip install cairosvg                  # SVG→PNG 备选
# 或 npm install puppeteer                 # SVG→PNG 备选（scripts/svg2png.js）

正文内联 <svg>...</svg> 块会自动渲染为 PNG 嵌入，渲染优先级 rsvg-convert → cairosvg → svg2png.js(puppeteer)，三者任一即可；全部不可用时降级为代码框显示 SVG 源码。

快速开始

主转换脚本：scripts/md2word.py

# 基本转换
python scripts/md2word.py input.md output.docx

# 使用预设格式
python scripts/md2word.py input.md --preset=academic

# 使用自定义配置
python scripts/md2word.py input.md --config=my-config.yaml

# 脚注/尾注模式（默认 footnote 页面脚注；endnote=文档末注释+上标编号）
python scripts/md2word.py input.md --notes=endnote

# 全书合并：多章 md → 单 docx（目录+章间分页+页眉，配合 -o 指定输出）
python scripts/md2word.py --book ch01.md ch02.md ch03.md -o book.docx --preset=book-publish

配置系统

内置预设

预设信息从 YAML 文件动态读取，运行以下命令查看完整列表：

python scripts/config.py --list

常用预设：

legal — 法律文书格式（默认）
service-plan — 法律服务方案（含分层配色）
minimal — 极简格式
academic — 学术论文格式
report — 工作报告格式
book-publish — 中文书籍出版格式（正文宋体、标题黑体、TOC/页眉书名，配合 --book 全书合并导出）

完整配置见 assets/presets/*.yaml，设计说明见 assets/theme-notes/

自定义配置

复制配置模板并修改：

cp assets/config-template.yaml my-config.yaml

Word 模板文件

将 .docx 模板放入 assets/templates/ 目录，或使用 --template 指定。

Word 模板 vs 配置文件：

Word 模板：控制视觉元素（页眉、页脚、Logo）
配置文件：控制格式参数（字号、行距、页边距）

参考文档

配置参考: references/config-reference.md
样式映射: references/style-mappings.md
使用示例: references/examples.md

所需权限与安全说明

本技能会调用本地脚本执行文档转换，涉及以下能力边界，请在使用前知悉：

本地代码执行

scripts/md2word.py 通过 subprocess.run 调用外部渲染工具渲染图表与 SVG：
- Mermaid 图表：调用 mmdc（MMDCCMD 环境变量 → 脚本同目录 node_modules/.bin/mmdc → 系统 PATH），仅渲染用户输入的 mermaid 代码，命令以参数数组拼接，不经过 shell 字符串拼接。
- SVG 渲染：按优先级调用 rsvg-convert → cairosvg → node scripts/svg2png.js（Puppeteer）。内联 SVG 为不可信输入时，可能触发渲染器解析问题或资源消耗，请只转换可信来源的文档。

网络访问（默认启用）

转换含外部 URL 图片的 Markdown 时会自动向任意 HTTP/HTTPS 地址发起请求（urllib.request，超时 20s），用于下载图片嵌入 Word。
这是默认行为：外链图片会正常下载并嵌入文档；下载失败时降级为文字占位符。
请知悉风险：处理不可信 Markdown 可能触发 SSRF（访问内网地址）、向第三方泄露转换方 IP/时间等元数据、引入恶意或超大图片负载。请仅转换可信来源的文档。
上述下载请求不会上传文档内容，只按 Markdown 中的图片 URL 拉取图片。

环境变量读取

chart_handler.py 读取 MMDCCMD 环境变量以定位 mermaid-cli 可执行文件（可选，未设置时回退到脚本同目录 node_modules 与系统 PATH）。

文件访问

读取用户指定的 Markdown 输入文件、assets/templates/ 下的 Word 模板与 assets/presets/ 下的 YAML 配置。
在输出目录生成 Word 文档（--book 模式会生成临时合并 Markdown，转换结束后自动删除）。

错误处理

文件编码：自动检测 UTF-8 和 GBK
模板找不到：使用默认格式创建新文档
Mermaid 失败：降级为文本描述
图片过大：自动压缩和调整尺寸

目录结构

md2word/
├── SKILL.md               # 本文档
├── CHANGELOG.md           # 版本记录
├── references/            # 参考文档
│   ├── config-reference.md
│   ├── style-mappings.md
│   └── examples.md
├── scripts/               # 转换脚本
│   ├── md2word.py         # 主脚本
│   ├── config.py          # 配置模块（含 --list 查看预设）
│   ├── extract_template_config.py  # 从 Word 模板提取配置
│   ├── formatter.py       # 文本格式化模块
│   ├── table_handler.py   # 表格处理模块
│   └── chart_handler.py   # 图表渲染模块
└── assets/                # 资源文件
    ├── presets/           # YAML 预设配置
    ├── theme-notes/       # 预设设计说明文档
    ├── templates/         # Word 模板文件
    └── config-template.yaml

同仓库更多 Skills

同仓库

clawhub-sync

cat-xierluo/legal-skills

将本地开发的 Skills 批量同步到 ClawHub 与腾讯 SkillHub 两个平台。支持智能 .gitignore 过滤、白名单控制、增量同步、单个 skill 同步、双平台分流发布。本技能应在用户需要将本地 skills 发布到 ClawHub/SkillHub、批量同步技能、检查发布状态时使用。

2026-08-03542

cross-agent-coordination

cat-xierluo/legal-skills

跨平台 Agent 任务协调枢纽。本技能应在多个不同平台的 Agent 需要围绕项目任务源分配任务、标记归属、能力路由和交接上下文时使用。不要用于单一平台内的本地并行执行，或 Git 分支、提交、PR、merge 安全规则。

2026-08-03542

universal-media-downloader

cat-xierluo/legal-skills

输入各类视频网站/播客平台链接后，自动下载对应媒体文件并交付给用户。优先使用 yt-dlp 覆盖抖音(Douyin)、B站(Bilibili)、YouTube 等常见视频网站，也可用于可直接暴露音频地址的播客平台（如小宇宙单集链接）。当遇到 403/登录/年龄或地区限制时，支持使用 cookies.txt 重试；对于可能存在 DRM/加密或条款限制的平台（例如部分 Spotify 内容），应提示用户仅下载其有权保存的内容，并在不可下载时建议改用官方离线/导出渠道或提供原始 RSS/直链。抖音视频在 yt-dlp 撞签名墙（"Fresh cookies needed"）时会自动 fallback 到无登录直连 aweme.snssdk.com/v1/play（仅需 video_id，不需要 cookie/a_bogus 签名）；抖音图文笔记暂不支持自动下载，需手动处理。

2026-08-03542

yuandian-law-search

cat-xierluo/legal-skills

元典法条与案例检索。本技能应在需要查询中国法律法规条文、检索相关案例、为法律分析提供数据支撑时使用。

2026-08-02542

pdf-processor

cat-xierluo/legal-skills

PDF 处理工具，支持扫描件预处理、OCR 双层 PDF、页码添加、PDF 合并、解密、水印去除和压缩。本技能应在用户需要一键处理、优化或整理 PDF 文档时使用。不要用于：纯文本 PDF 内容编辑、PDF 阅读与批注、电子签名、非压缩目的的格式转换。

2026-08-01542

patent-analysis

cat-xierluo/legal-skills

面向中国发明和实用新型专利的结构化初步分析工具。本技能应在用户需要拆解或解释权利要求、比较专利保护范围、进行产品侵权比对、等同分析、稳定性与无效风险分析、FTO、规避设计、专利价值评估或制作专利分析图表时使用。不要用于：代替专利律师或专利代理师出具正式意见、仅下载/OCR专利、撰写专利申请文件，或在未确认法域与有效权利要求时给出确定性结论；外观设计近似判断需另行采用专门方法并人工复核。

2026-08-01542

name	md2word
homepage	https://github.com/cat-xierluo/legal-skills
author	杨卫薪律师（微信ywxlaw）
version	1.2.0
license	MIT
description	Markdown转Word文档技能。将Markdown文档转换为符合中文排版标准的专业格式Word文档，支持多种预设格式。适用于正式文档、论文、报告等需要规范排版的文档转换。

Markdown转Word文档Skill

概述

将 Markdown 文档转换为符合中文排版标准的 Word 文档。支持完整的 Markdown 语法，自动应用专业格式设置。

依赖要求

Python 依赖

pip install python-docx Pillow beautifulsoup4 PyYAML

可选依赖

npm install -g @mermaid-js/mermaid-cli   # Mermaid 图表渲染
brew install librsvg                       # SVG→PNG（推荐，rsvg-convert）
# 或 pip install cairosvg                  # SVG→PNG 备选
# 或 npm install puppeteer                 # SVG→PNG 备选（scripts/svg2png.js）

正文内联 <svg>...</svg> 块会自动渲染为 PNG 嵌入，渲染优先级 rsvg-convert → cairosvg → svg2png.js(puppeteer)，三者任一即可；全部不可用时降级为代码框显示 SVG 源码。

快速开始

主转换脚本：scripts/md2word.py

# 基本转换
python scripts/md2word.py input.md output.docx

# 使用预设格式
python scripts/md2word.py input.md --preset=academic

# 使用自定义配置
python scripts/md2word.py input.md --config=my-config.yaml

# 脚注/尾注模式（默认 footnote 页面脚注；endnote=文档末注释+上标编号）
python scripts/md2word.py input.md --notes=endnote

# 全书合并：多章 md → 单 docx（目录+章间分页+页眉，配合 -o 指定输出）
python scripts/md2word.py --book ch01.md ch02.md ch03.md -o book.docx --preset=book-publish

配置系统

内置预设

预设信息从 YAML 文件动态读取，运行以下命令查看完整列表：

python scripts/config.py --list

常用预设：

legal — 法律文书格式（默认）
service-plan — 法律服务方案（含分层配色）
minimal — 极简格式
academic — 学术论文格式
report — 工作报告格式
book-publish — 中文书籍出版格式（正文宋体、标题黑体、TOC/页眉书名，配合 --book 全书合并导出）

完整配置见 assets/presets/*.yaml，设计说明见 assets/theme-notes/

自定义配置

复制配置模板并修改：

cp assets/config-template.yaml my-config.yaml

Word 模板文件

将 .docx 模板放入 assets/templates/ 目录，或使用 --template 指定。

Word 模板 vs 配置文件：

Word 模板：控制视觉元素（页眉、页脚、Logo）
配置文件：控制格式参数（字号、行距、页边距）

参考文档

配置参考: references/config-reference.md
样式映射: references/style-mappings.md
使用示例: references/examples.md

所需权限与安全说明

本技能会调用本地脚本执行文档转换，涉及以下能力边界，请在使用前知悉：

本地代码执行

scripts/md2word.py 通过 subprocess.run 调用外部渲染工具渲染图表与 SVG：
- Mermaid 图表：调用 mmdc（MMDCCMD 环境变量 → 脚本同目录 node_modules/.bin/mmdc → 系统 PATH），仅渲染用户输入的 mermaid 代码，命令以参数数组拼接，不经过 shell 字符串拼接。
- SVG 渲染：按优先级调用 rsvg-convert → cairosvg → node scripts/svg2png.js（Puppeteer）。内联 SVG 为不可信输入时，可能触发渲染器解析问题或资源消耗，请只转换可信来源的文档。

网络访问（默认启用）

转换含外部 URL 图片的 Markdown 时会自动向任意 HTTP/HTTPS 地址发起请求（urllib.request，超时 20s），用于下载图片嵌入 Word。
这是默认行为：外链图片会正常下载并嵌入文档；下载失败时降级为文字占位符。
请知悉风险：处理不可信 Markdown 可能触发 SSRF（访问内网地址）、向第三方泄露转换方 IP/时间等元数据、引入恶意或超大图片负载。请仅转换可信来源的文档。
上述下载请求不会上传文档内容，只按 Markdown 中的图片 URL 拉取图片。

环境变量读取

chart_handler.py 读取 MMDCCMD 环境变量以定位 mermaid-cli 可执行文件（可选，未设置时回退到脚本同目录 node_modules 与系统 PATH）。

文件访问

读取用户指定的 Markdown 输入文件、assets/templates/ 下的 Word 模板与 assets/presets/ 下的 YAML 配置。
在输出目录生成 Word 文档（--book 模式会生成临时合并 Markdown，转换结束后自动删除）。

错误处理

文件编码：自动检测 UTF-8 和 GBK
模板找不到：使用默认格式创建新文档
Mermaid 失败：降级为文本描述
图片过大：自动压缩和调整尺寸

目录结构

md2word/
├── SKILL.md               # 本文档
├── CHANGELOG.md           # 版本记录
├── references/            # 参考文档
│   ├── config-reference.md
│   ├── style-mappings.md
│   └── examples.md
├── scripts/               # 转换脚本
│   ├── md2word.py         # 主脚本
│   ├── config.py          # 配置模块（含 --list 查看预设）
│   ├── extract_template_config.py  # 从 Word 模板提取配置
│   ├── formatter.py       # 文本格式化模块
│   ├── table_handler.py   # 表格处理模块
│   └── chart_handler.py   # 图表渲染模块
└── assets/                # 资源文件
    ├── presets/           # YAML 预设配置
    ├── theme-notes/       # 预设设计说明文档
    ├── templates/         # Word 模板文件
    └── config-template.yaml