核心用法
docx-formatter 是一款专为中国党政机关、企事业单位设计的公文格式自动化工具。用户可通过 Markdown 或 JSON 输入内容，工具自动转换为符合《党政机关公文格式》（GB/T 9704-2012）标准的 .docx 文档。
推荐工作流：
1. 首次运行 ./install.sh 完成环境初始化
2. 使用 Markdown 编写内容，通过 # 层级标记标题结构
3. 执行 ./docx-formatter --from-markdown input.md --output output.docx 生成标准文档
4. 可选添加 --author 参数自动插入署名与日期
输入格式规范：
# 文档标题→ 方正小标宋简体 2号（大标题）## 一、一级标题→ 黑体 3号### （一）二级标题→ 楷体_GB2312 3号- 正文段落 → 仿宋_GB2312 3号，首行缩进2字符
- 行间距固定28磅，A4纸张，页边距上下1英寸、左右1.25英寸
---
显著优点
1. 权威性合规：严格对标 GB/T 9704-2012 国家标准，字体、字号、行距、页边距等细节完全契合党政公文规范
2. 效率倍增：告别手动调格式的繁琐，Markdown 输入实现"内容专注"，一键输出专业排版
3. 中文特性优化：自动处理中文引号配对、书名号、括号等标点符号，避免西文标点混入
4. 场景覆盖全面：支持述职报告、民主生活会对照检查、工作总结、实施方案等高频公文类型
---
潜在局限
1. 依赖本地环境：需安装 Python 及 python-docx 等依赖，首次配置需技术门槛
2. 字体依赖严格：方正小标宋、楷体_GB2312、仿宋_GB2312 等字体需本地预装，缺失将导致格式降级
3. 复杂表格受限：当前版本以段落排版为主，复杂表格、图文混排能力有限
4. 平台绑定：目前仅支持类 Unix 环境（Linux/macOS），Windows 需借助 WSL
---
适合人群
- 党政机关文秘人员：批量生成通知、通报、报告等标准公文
- 国企/事业单位综合办：快速产出述职述廉、民主生活会材料
- 公文写作培训学员：学习标准格式的可视化参照
- 重视规范性的写作者：追求"一眼专业"的文档呈现效果
---
常规风险提醒
- 字体版权：方正字体需确认商用授权，建议单位统一采购或替换为开源替代方案
- 内容合规：工具仅保障格式合规，内容政治性、保密性需人工审核
- 版本兼容性：生成文档建议用 Microsoft Word 或 WPS 打开，部分第三方阅读器可能渲染偏差