# DOCX Export

> 把中文公文 Markdown 成稿导出为符合机关版式的 .docx。Use when the user wants to export/convert a 公文 Markdown draft to Word/.docx, adjust 字体、字号、页边距、行距、页码、标题断行, embed local images as 附件/附图, or inspect the resolved 字体与版式方案. 不负责起草内容，只负责渲染版式。

- Skill: `zhaohui-yang/docx-export` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zhaohui-yang/docx-export`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaohui-yang/docx-export/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: zhaohui-yang (https://skillmd.com/u/zhaohui-yang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhaohui-yang/docx-export

---


# 公文 docx 导出

把已成稿的中文公文 Markdown 渲染成符合机关版式的 `.docx`。这是「版式渲染」能力，**不起草内容**——起草走根目录「公文写作」skill，本 skill 只在 Markdown 结构正确后做导出与版式调整。

与「公文写作」共用同一份 `prompts/` 主源（字体方案、版式方案、文种绑定），不复制规则。

## 文件索引

```
src/scripts/generate_docx.py            # 导出器主入口（CLI）
src/scripts/install_fonts.sh            # 安装 assets/fonts/ 下字体到系统
src/scripts/download_fonts.sh           # 拉取开源替代字体
prompts/font-profiles/*.toml        # 字体方案（标题/正文/层级字体字号）
prompts/layout-profiles/*.toml      # 版式方案（固定行距、各段后距、首行缩进）
prompts/doc-types/<id>-<文种>/meta.toml  # 文种 → font_profile / layout_profile 绑定
assets/fonts/catalog.toml           # 字体族 → assets/fonts/ 具体文件映射
docs/references/font-usage.md            # 字体速查、导出已知坑、自检命令（面向读者）
docs/references/layout-rules.md          # 版式规范、已自动化/未自动化清单、页边距
```

## 调用方式

- 先确认 Markdown 结构正确（标题、主送单位、正文、落款、附注、附件等用 `##` 分块）。
- 按文种自动套字体与版式：`--doc-type <文种>`（中文别名或英文 ID 均可），脚本据 `meta.toml` 解析 `font_profile`/`layout_profile`。
- 或手动指定：`--font-preset`、`--title-font`、`--body-font` 等槽位。
- 导出前可用 `--show-font-plan` / `--show-layout-plan` 预览实际落到的字体、字号、版式参数。

```bash
python3 src/scripts/generate_docx.py 成稿.md -o 成稿.docx --doc-type 通知
python3 src/scripts/generate_docx.py --doc-type 报告 --show-font-plan      # 预览不导出
```

## 默认版式（主源）

- 页边距：按 GB/T 9704-2012，上 37mm、下 35mm、左 28mm、右 26mm（版心 156mm×225mm；常量真身在 `src/docgen/constants.py` 的 `MARGIN_*_TWIPS`，经 `src/scripts/generate_docx.py` 再导出）。
- 行距、各段后距、首行缩进：由文种绑定的 `prompts/layout-profiles/*.toml` 决定，不在文档里重复硬编码数值。
- 标题/正文/层级字体字号：由 `prompts/font-profiles/*.toml` + `assets/fonts/catalog.toml` 决定。
- 调整版式优先改对应 `*.toml` 主源；只在一次性需求时用 CLI 覆盖。

## 已知坑（症状 / 成因 / 对策）

- **换机器字体变样**：脚本只写字体名、不嵌入 `.ttf`；目标机器先 `bash src/scripts/install_fonts.sh`，锁定视觉时导出 PDF。
- **图片没出现**：仅支持本地 `png/jpg/jpeg`，用 `![图1 标题](./本地路径.png)` 独立成块，优先放 `附件/附图/附录`。
- **首页无页脚页码**：预期行为（自第二页起显示）；完全不要页码加 `--hide-page-number`。
- **页脚灰底**：是编辑器“域底纹”显示，非文档底纹。

更完整的字体速查与命令见 `docs/references/font-usage.md`，版式规范见 `docs/references/layout-rules.md`。

## 边界

- 不在自动化范围：机关红头套版、印章压成文日期、完整套红线——仍需用本单位 Word 模板做最后核定。
- 改字体/版式后若涉及 `*.toml` 主源，跑 `python3 src/adapters/skill/build.py --check` 确认产物同步。