文档格式刷 (Doc Format Brush)#

概述#

本 skill 提供多格式文档格式整理功能： 提取 模板文档的格式 → 应用 到任意格式的目标文档。

核心功能#

1. 多格式支持：输入/输出支持 Word(.docx)、Markdown(.md)、纯文本(.txt)
2. 智能标题层级识别：自动识别标题、一级标题（"一、"）、二级标题（"（一）"）、正文
3. 格式精确复制：字体、字号、加粗、对齐、首行缩进（字符级）、段前间距、段后间距、行间距、页边距
4. 内置公文格式：支持一键应用 GB/T 9704-2012 国家标准公文格式

---

使用方式#

方式一：使用内置公文格式（推荐）#

当用户需要将文档调整为标准公文格式时：

bash

python apply_multi_format.py <输入文档> --official --output <输出文档>

支持的输入格式：.docx, .md, .txt 支持的输出格式：.docx, .md, .txt

示例：

bash

# Markdown 转 Word 公文格式
python apply_multi_format.py 报告.md --official --output 报告_公文.docx

# 纯文本转 Markdown
python apply_multi_format.py 笔记.txt --official --output 笔记.md

# Word 转为 Word（使用公文格式）
python apply_multi_format.py 财务报告.docx --official --output 财务报告_公文格式.docx

---

方式二：参照模板文档#

当用户提供了特定的模板文档时：

从模板提取格式后应用到目标：

bash

python apply_multi_format.py <目标文档> <模板.docx> --output <输出文档>

示例：

bash

# 参照 Word 模板，调整 Markdown 文件
python apply_multi_format.py 报告.md 模板.docx --output 报告_新格式.docx

# 参照模板，转换 Word 到 Word
python apply_multi_format.py 源文件.docx 模板.docx --output 目标文件.docx

---

方式三：使用格式描述文件#

可以先提取模板格式为 JSON，然后复用：

bash

# 提取格式
python extract_format.py 模板.docx --output 格式.json

# 应用格式
python apply_multi_format.py 输入.md --format-json 格式.json --输出 输出.docx

---

内置公文格式规范（GB/T 9704-2012）#

段落类型字体字号对齐缩进段前段后行距标题方正小标宋体22pt（二号）居中00pt0pt1.5倍文号仿宋_GB231216pt（三号）居中00pt0pt1.5倍一级标题黑体16pt（三号）左对齐00pt0pt1.5倍二级标题楷体_GB231216pt（三号）左对齐00pt0pt1.5倍正文仿宋_GB231216pt（三号）两端对齐2字符0pt0pt1.5倍

页面设置：

• 纸张：A4（21cm × 29.7cm）
• 页边距：上 3.7cm，下 3.5cm，左 2.8cm，右 2.6cm

---

标题层级识别规则#

Word/文本识别规则#

类型识别规则示例标题第一个非空段落关于xxx的请示文号第二个段落，符合公文号格式X发〔2024〕10号一级标题以"一、"、"二、"等开头一、基本情况二级标题以"（一）"、"（二）"等开头（一）主要业绩正文其他段落正文内容...

Markdown 识别规则#

Markdown 标记对应层级# Title标题## Heading一级标题### Subheading二级标题- List item正文（列表项）普通文本正文

---

格式转换矩阵#

输入格式支持的输出格式说明.docx.docx, .md, .txt保留格式信息.md.docx, .md, .txt识别标题层级.txt.docx, .md, .txt智能识别标题

---

脚本位置#

本 skill 包含以下脚本：

脚本功能extract_format.py从 Word 模板提取格式 → 输出 JSONapply_format.py应用格式到 Word 文档apply_multi_format.py**【推荐】**多格式统一处理入口format_bridge.py多格式文档读写核心库

脚本目录： C:\Users\14032\.codebuddy\skills\doc-format-brush\scripts\

---

常见错误与修正#

错误现象原因修正方式首行缩进显示为厘米而非字符使用了 Cm() 而非 XML 属性使用 w:firstLineChars 设置字符数段后间距仍有 10ptWord Normal 样式默认值未覆盖强制 pf.space_after = Pt(0)对齐方式为左对齐而非两端对齐未正确设置 JUSTIFY使用 WD_ALIGN_PARAGRAPH.JUSTIFY中文字体未变化只设了 font.name同时设置 w:eastAsia 属性文件保存报 PermissionError目标文件在 Word 中打开换一个新文件名保存

---

典型对话示例#

用户 A： "把这份 Markdown 报告改成公文格式 Word"

AI： 使用内置公文格式处理 Markdown：

bash

python apply_multi_format.py 报告.md --official --output 报告_公文格式.docx

用户 B： "参照这个 Word 模板，调整我的笔记文件"

AI： 参照模板格式处理：

bash

python apply_multi_format.py 我的笔记.md 模板.docx --output 笔记_整理.docx

用户 C： "把这个文本文件转成带格式的 Markdown"

AI： 使用内置格式输出 Markdown：

bash

python apply_multi_format.py 原始笔记.txt --official --output 格式化笔记.md