公文版式工具
标准依据与边界
GB/T 9704-2012《党政机关公文格式》现行，2025-05-30 复审继续有效。其适用于党政机关制发公文；其他机关、单位可以参照执行。
先读 references/gbt9704-2012-summary.md；需要逐项复核时再读 references/gbt9704-audit-matrix.md 和 references/formal-checklist.md。标准规定纸张、版面、要素编排和印制装订要求。
工具定位
本工具只处理排版，不判断单位身份、授权状态或后续盖章方式。它会根据用户明确选择的版式模式应用对应的排版规则，不因“正式”“国企”“报告”或仅提供机构名称而擅自使用红头。
生成器可输出 A4、156mm×225mm 版心、三号仿宋正文、小标宋二号标题、四级标题层次、两字缩进，以及居中或单双页页码。四级标题均写入 Word/WPS 标题样式和大纲级别，便于后续插入、更新目录；文章总标题使用独立“公文标题”样式，不进入目录。上行文的文号和签发人在同一行编排，左右各空一字；信函、命令（令）、纪要和横排表格使用各自专用版式；电子联合行文可重复传入 --joint-org；主办机关在前，联署机关名称分行排列；输入含“文件”时将“文件”置右并按联署名称上下居中；分离装订附件可加 --attachment-detached；重复传入 --attachment-file 时必须同时提供与附件顺序、标题一致的 --attachment-note，附件会另页生成并保持页码连续。版记会锚定最后一页版心底部，正式页码按版心下边缘下7mm的位置生成。正式版头的份号、密级、紧急程度和电子机关标志以版心上边缘为垂直锚点固定定位，不会因为左上字段而把机关标志或预印红头留白向下推移。只有传入密级而未传入份号时，首行会保留空位，密级仍从第二行开始。
references/formal-checklist.md 是可选的版式复核清单。涉及印章或签名章时，使用者可在 Word/WPS 中插入已取得的图片或完成实体盖章；本生成器不内置印章图像。
生成打印稿
node scripts/generate_gongwen_docx.mjs --input source.md --output output.docx --format ordinary --title "文档标题"
普通材料使用 --format ordinary，默认居中页码，不绘制红头。正式发文须显式使用 --format formal；其默认 --letterhead preprinted，即首面预留红头纸区域、不在 DOCX 中重绘纸上已有的红色机关标志和红线。--doc-no 等本次需打印的黑色变量仍可保留。只有明确要求完整电子版时使用 --letterhead digital。完整电子红头的机关标志按标准推荐使用小标宋体，标题按标准使用小标宋体；生成器会在缺失时明确警告并记录实际替代字体，需要硬性阻止替代输出时加 --require-standard-fonts。红线下标题按28磅版心网格空二行。
# 预印红头纸套打；72mm 是默认机关标志区域起点，可按实际纸样调为 37—130mm
node scripts/generate_gongwen_docx.mjs --input source.md --output output.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org "发文机关名称" --doc-no "单位发〔2026〕1号" --title "文档标题" --sender "落款单位" --date "2026年9月9日"
# 完整电子红头版，仅在明确要求时使用
node scripts/generate_gongwen_docx.mjs --input source.md --output output.docx --format formal --letterhead digital --org "发文机关名称" --doc-no "单位发〔2026〕1号" --title "文档标题"
letter、command、minutes、horizontal-table 分别对应信函、命令（令）、纪要和横排表格格式；需要时显式传入 --format 和相应字段。横排表格会生成横向A4页面和225mm表格，单双页表头在订口/切口的朝向仍需目标 Word/WPS 模板核对。联合行文使用 --joint-org，主办机关在前、联署机关名称分行排列；输入含“文件”时将“文件”置右并按联署名称上下居中；附件不能与正文一起装订时使用 --attachment-detached，附件首行会补排文号和附件序号。command 会要求机关标志以“命令”或“令”结尾；信函中的份号、密级和紧急程度会在第一条双线下按标准顺序编排，联合行文和机关专用信函模板仍需目标软件核对。正式发文默认单双页页码；standard 为单页右、双页左，center 与 none 供普通材料选择。
附件可重复传入 --attachment-file attachment.md。附件 Markdown 的首个一级标题会作为附件标题，第一页第一行写“附件1”（后续文件递增），第三行写标题，随后排正文；附件说明通过 --attachment-note 提供，工具会统一为“附件：”并去除末尾标点，同时拒绝顺序或标题与附件文件不一致的输入。复杂横排附件、不能与正文一起装订的附件和机关专用模板仍需在目标 Word/WPS 中核对。
正式版式的 --doc-no 采用“单位发〔2026〕1号”这类标准写法；--date、--print-date 采用“2026年9月9日”，月份和日期不补零。明显不符合这两类规则的输入会被拒绝，避免把错误字段排成看似规范的文件。
Markdown 标题优先按序数识别：一、、（一）、1.、（1）；序数缺失时才按 Markdown 层级映射。正文、四级标题均左空二字，回行顶格。标题字体在运行机器缺失时会明确报告并使用可见替代字体；打开文件时仍须确认目标 Office/WPS 的实际字体，不把普通宋体视作小标宋的等价替代。
验证
unzip -t output.docx
soffice --headless --convert-to pdf --outdir /tmp output.docx
node scripts/verify_gongwen_docx.mjs --input output.docx --profile formal --letterhead preprinted
# 目标电脑必须装有标准小标宋体和仿宋体时，再加严格字体校验
node scripts/verify_gongwen_docx.mjs --input output.docx --profile formal --letterhead digital --require-standard-fonts
# 逐场景生成 DOCX、PDF 和 PNG，人工按截图核对版式
bash tests/visual-audit.sh /tmp/gongwen-visual-audit
全条款视觉证据和未自动化边界见GB/T 9704-2012 全条款视觉核验记录和全条款截图证据矩阵。横排表格的单双页表头方向、实体印章、纸张和装订不能只由 DOCX 生成器证明。
校验器核验生成器可检查的版式要素，并按 ordinary、formal、letter、command、minutes、horizontal-table 选择校验档案。输出后仍须在目标 Word/WPS 与实际打印条件下检查首页正文、分页、附件、表格、页码、红头纸套打和装订。
输出说明
- 版式检查通过后，可写“已按 GB/T 9704-2012 的相关版式参数生成”。
- 使用者可按实际用途决定是否采用
formal-checklist.md 逐项复核。