关于 md-to-docx-template
md-to-docx-template 是将 Markdown 转换为带样式 Word 文档的技能。它支持自定义模板、提取现有文档样式,并可通过清单组合多个文件。
主要功能
- 01将 Markdown 转换为 DOCX
- 02应用自定义参考模板
- 03按指定字体和颜色创建模板
- 04从品牌 DOCX 提取样式
- 05通过清单组合多个文件
- 06生成目录
适用场景
- 01将 Markdown 内容转换为 Word 文档
- 02应用组织的文档样式
- 03将多个 Markdown 文件合并为一份文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jonnyschneider/ skills --skill md-to-docx-template安装后在 Claude Code 中输入/md-to-docx-template确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
apply-template-styles.pycreate-reference-template.pyextract-styles.pyfix-fonts.pyfix-list-indent.pyfix-table-headers.pymd-to-docx.pyREADME.md详细介绍
使用模板将 Markdown 转换为 DOCX
将 Markdown 转换为具有专业样式的 Word 文档。不是普通导出,而是精美、符合品牌形象的文档,并自动应用你的字体、颜色和表格样式。
适用场景
- 用户想将 Markdown 转换为 Word/DOCX
- 用户需要从 Markdown 源文件生成符合品牌形象的文档
- 用户询问如何导出带样式的 Markdown
- 用户提到“md to docx”“markdown to word”或类似说法
先决条件
- 已安装
pandoc(macOS 上运行brew install pandoc) - Python 3.8+,并安装以下软件包:
python-docx、lxml、click、pyyaml
安装
将此技能的脚本克隆到你选择的位置:
git clone https://github.com/jonnyschneider/skills
cd skills/skills/md-to-docx-template
pip install python-docx lxml click pyyaml
快速转换
./md-to-docx.py input.md -o output.docx
使用自定义模板
选项 A:使用指定的字体和颜色生成模板
./create-reference-template.py template.docx \
--font-body "DM Sans" \
--font-heading "DM Sans" \
--accent-color "0D494D" \
--heading-color "0D494D"
./md-to-docx.py input.md -o output.docx --template template.docx
选项 B:从现有的品牌文档中提取样式
# Full pipeline for best results:
./extract-styles.py source-branded.docx template.docx
./md-to-docx.py input.md -o output.docx --template template.docx --no-fix-indent
./apply-template-styles.py template.docx output.docx
./fix-table-headers.py output.docx
多文件文档
创建 manifest.yaml:
template: template.docx
output: final-document.docx
sections:
- 01-intro.md
- 02-content.md
- 03-conclusion.md
然后运行:
./md-to-docx.py manifest.yaml --open
主要选项
| 选项 | 说明 |
|---|---|
-o, --output | 输出 DOCX 路径 |
--template | 自定义参考模板 |
--toc | 生成目录 |
--open | 构建后打开 |
--no-fix-indent | 跳过列表缩进修复(与提取流程搭配使用) |
模板选项
| 选项 | 说明 |
|---|---|
--font-body | 正文字体(默认:Calibri) |
--font-heading | 标题字体(默认:Calibri) |
--font-mono | 代码字体(默认:Consolas) |
--accent-color | 表格标题颜色(十六进制,默认:4472C4) |
--heading-color | 标题文本颜色(十六进制,默认:000000) |
限制
- 目标计算机必须安装自定义字体
- 复杂表格可能无法完美呈现
- SVG 图像需要
rsvg-convert - 某些 pandoc 特性需要后处理脚本
评论
支持 Markdown