核心用法
docx-formatter 是一款专为中国公文格式规范设计的文档生成工具,核心功能是将 Markdown 或 JSON 格式的结构化内容自动转换为符合《党政机关公文格式》(GB/T 9704)标准的 .docx 文件。
两种输入模式:
1. 推荐模式:./docx-formatter --from-markdown input.md --output output.docx --author "单位\n日期",支持自动识别标题层级、应用对应字体格式
2. 高级模式:通过 JSON 精确控制文档结构,适合程序化调用
格式自动处理:
- 字体层级:方正小标宋(大标题)→ 黑体(一级)→ 楷体_GB2312(二级)→ 仿宋_GB2312(正文/三级加粗)
- 段落规范:固定行距 28 磅、首行缩进 2 字符、两端对齐
- 页面设置:A4 纸张、页边距上下 1" 左右 1.25"、页脚居中数字页码
显著优点
1. 权威性合规:严格对标 GB/T 9704 国家标准,非近似模拟
2. 效率极高:Markdown 写作 + 一键转换,避免 Word 手动排版耗时
3. 容错友好:首次使用自动检测依赖并执行安装脚本,降低部署门槛
4. 党政场景深度优化:内置民主生活会、述职报告、对照检查等模板语义
潜在局限
1. 字体依赖:方正小标宋、楷体_GB2312 等需系统预装,Linux/Mac 环境可能缺失
2. 扩展性受限:仅支持特定 Markdown 语法子集,复杂表格、图文混排能力未明确
3. 签名信息:安全报告为系统占位生成,未经过实际安全扫描
适合人群
- 党政机关文秘人员:高频处理请示、报告、方案、总结
- 国企/事业单位行政岗:需快速产出格式合规的正式材料
- 党建工作者:民主生活会、组织生活会材料标准化生成
常规风险
- 依赖本地字体文件,跨平台使用时可能出现字体回退导致格式偏差
- 建议生成后人工复核页码、印章预留位置等细节
- Markdown 中的特殊符号(如英文引号)需确认已自动转为中文标点