content-to-word — 内容转 Word
把任意 Markdown 内容渲染成一份排版专业、可直接交付的 .docx。渲染引擎已内置中文字体、行距、标题层级、表格样式、代码块底纹、页眉页脚、封面与目录——不要用 python-docx 从零手写排版，全部交给引擎。
何时使用
- 用户说"导出 Word / 生成 docx / 转成 Word / 输出为 word 格式 / 做成文档"
- 对话中产出了报告、方案、分析结论、评审意见，需要落成正式文档交付
- 需要把 markdown 表格 / 代码 / 清List 整理成可编辑的 Word
不使用本技能的情况：
- 需要仿照某份参考文档的版式、或套用复杂模板 → 用
tencent-docx（专业 Word 创作美化） - 用户要的是 Excel → 用
content-to-excel；要 PPT → 用ppt-builder - 编辑已存在的 docx 文件 → 用
tencent-docx
工作流程
第 1 步：整理内容为 Markdown
从对话上下文中提炼内容，写成一个 .md 文件（如 报告.md），保存到工作目录。要点：
- 标题层级用
#~####，层级要规整（H1 章 → H2 节 → H3 小节） - 数据对比用 markdown 表格，命令/代码用围栏代码块并标注语言
- 文档元信息写在开头 front matter（引擎会自动读取）：
---
title: 文档标题
subtitle: 副标题
author: 作者
date: 2026年10月18日
---
编号规则：标题里手写编号（一、、1.1、第1章）与 --numbering 二选一。引擎会自动检测：某级标题多数已带手写编号时，自动跳过该级的自动编号，不会出现「1 一、xxx」叠加。
第 2 步：渲染
"<venv python>" <skill>/scripts/docx_engine.py 报告.md -o 输出.docx [选项]
<venv python> 固定为 C:\Users\huliy\.workbuddy\binaries\python\envs\default\Scripts\python.exe（已装 python-docx；缺则 pip install python-docx 装进该 venv）。<skill> 是本技能目录。
常用参数组合：
| 场景 | 命令参数 |
|---|---|
| 快速导出（默认样式） | -o 输出.docx |
| 正式交付（带封面目录） | --cover --toc --theme business |
| 论文 / 正式文档 | --theme academic --cover --toc（自动首行缩进2字符） |
| 轻量笔记风 | --theme minimal |
| 轻松分享 / 周报 | --theme warm |
| 标题无编号时自动编号 | --numbering |
| 横向纸张（宽表格） | --landscape |
| 只要标题和结构，先看效果 | --dry-run |
完整参数见 references/themes.md。
第 3 步：校验与交付
- 确认末行输出
OK <路径> | ...，统计与内容规模相符（标题数、表格数） - 用
present_files交付.docx - 回复中一句话说明：主题、页数规模、是否含封面/目录
输出规范
- 默认 A4、上下 2.54cm / 左右 2.8cm 边距、页脚居中页码
--cover时首页无页眉页脚（首页不同）--toc时 Word 打开会提示"更新域"→ 是 → 自动生成目录和页码（已写入 updateFields 标记）- 表格跨页自动重复表头，斑马纹，表头深色底白字
- 代码块等宽字体灰底，保留缩进
注意事项
- 中文软换行合并：段落内换行按中文规则拼接（中文间不加空格），不用担心把 md 按 80 列硬换行
- 图片
支持绝对/相对路径（相对 md 所在目录），自动等比缩放到版心宽，说明文字作为图注居中 - 链接
[文字](url)渲染为真实超链接（主题色+下划线） - 任务列表
- [x]渲染为 ☑ / ☐ - 引擎报错先看消息再修 md；不要绕过引擎手写 python-docx 代码
- 支持语法明细：
references/markdown-syntax.md
Resources
scripts/docx_engine.py
渲染引擎。单文件，无外部服务依赖。
references/themes.md
4 套主题的字体、配色、适用场景，以及全部命令行参数说明。
references/markdown-syntax.md
支持的 Markdown 语法清单与渲染效果对照。
