--- name: Word Format slug: word-format category: Automation description: Word Format copies the visual formatting from a reference .docx onto new content. Use it when you need to continue an existing document, match a template, or fix inconsistent fonts, spacing, and alignment on macOS. github: "https://github.com/yeap531/word-format-skill/tree/main/skills/word-format" language: Shell stars: 202 forks: 8 install: "npx degit https://github.com/yeap531/word-format-skill/tree/main/skills/word-format ~/.claude/skills/word-format" installs_to: ~/.claude/skills/word-format source_path: skills/word-format/SKILL.md collection_size: 1 category_size: 1956 added: 2026-09-05T05:30:12.790Z last_synced: 2026-09-05T05:30:12.790Z canonical_url: "https://dirskills.com/skills/word-format" --- # Word Format Word Format copies the visual formatting from a reference .docx onto new content. Use it when you need to continue an existing document, match a template, or fix inconsistent fonts, spacing, and alignment on macOS. **Install:** ```bash npx degit https://github.com/yeap531/word-format-skill/tree/main/skills/word-format ~/.claude/skills/word-format ``` ## README # word-format 把参考 Word 文档的排版**视觉一致地**复刻到新内容上。工作方式：**直接在原件 HTML 上增删改文字**，再让浏览器渲染并把富文本送进 Word。 ## 工作原理：HTML Bridge ``` 参考 .docx │ ① docx_to_html.py ▼ Word Filtered HTML（原件，所有样式 inline） │ ② Claude 在原件上增删改文本（保留所有 inline style） ▼ edited.html │ ③ render_and_paste.sh │ 浏览器渲染 → Cmd+A/C → Word 粘贴 → 保存 ▼ 最终 .docx ``` **步骤 ③ 有两种模式，决定能保留多少模板格式：** | 模式 | 命令 | 能保留 | |---|---|---| | **B. 续写（推荐）** | `--append-to ` | **100% 模板格式**：页面设置、样式表、主题、页眉页脚、字体表 + 字符级排版 | | A. 新建 | （不带 `--append-to`） | 仅字符/段落级排版（字体/字号/缩进/行距/对齐） | > **想 100% 保留模板格式 → 必须用模式 B。** > 浏览器粘贴管线本身只能传字符级直接属性，不传`@page`/样式表/theme1.xml。 > 模式 B 的诀窍：**不靠粘贴管线传这些**——直接复制原 .docx 副本作为承载文档，新内容用 Cmd+A → → → Cmd+V 续写到末尾，原文档的页面设置 / 样式表 / 主题原封不动地继承下来。 ## 为什么不直接让 Word 打开生成的 HTML 再另存为 .docx 走「Word 打开 HTML → 另存 docx」的是 Word 的 **Open Web Page 遗留导入器**，对通用 HTML 行为保守诡异： - 字体回退链评估方式与浏览器不同，`font-family: '宋体', SimSun, serif` 可能落到默认字体 - `text-indent`、`line-height` 在导入时会被 clamp 到 Word 默认范围 - `` 的 padding/margin 不严格遵守 CSS spec 而**当前方案：浏览器渲染 → 系统剪贴板 → Word 粘贴**，走的是 Word 的「粘贴外部富文本」管线： - 浏览器是严格的 CSS 渲染器，**所见即所得** - 字体在浏览器渲染那一刻就钉死，剪贴板里携带的是确定的字体名 - Word 粘贴管线把剪贴板里的 HTML+RTF **直接展开成段落直接属性**，跳过 HTML 导入器对 inline-CSS HTML 而言，这是中间损失最小的链路。 ## 环境要求 - **OS**: macOS（脚本依赖 AppleScript / System Events） - **Microsoft Word for Mac**（`/Applications/Microsoft Word.app`） - **浏览器**: Google Chrome（首选）或 Safari - **Python 3**：系统自带，无第三方依赖 - **首次运行须开启系统授权**： - 系统设置 → 隐私与安全性 → **自动化**：勾选允许「终端宿主进程（Terminal / iTerm / Ghostty / Claude Code）」控制 Microsoft Word、Chrome（或 Safari）、System Events - 系统设置 → 隐私与安全性 → **辅助功能**：启用同一个宿主进程环境检查： ```bash bash "${SKILL_DIR}/scripts/verify_env.sh" ``` ## ⚠️ 给 Claude 的硬约束 prompt（编辑 HTML 时必须遵守） > 请帮我生成一段**专门用于复制粘贴到 Word 文档**的 HTML 排版代码。 > 核心要求如下： > > 1. **必须采用"行内样式"（Inline CSS）的写法**：请把所有的样式规则（如字体、字号、间距）直接写在每一个 HTML 标签的 `style` 属性里面，不要使用 `