商务文档专业排版

为什么需要这个技能

从 Markdown 或纯文本整理出一份能直接发给客户的 Word 报告，往往不是内容写不出来，而是排版这一步卡住：

• 随手写出的 #、## 在 Word 里只是黑色文字，没有任何层级感
• 复制粘贴到 Word 后字体不统一，表格没有表头底色，段落间距全靠运气
• 手工调一遍 50 页文档的样式，时间可能比写稿还长

biz-doc-formatter 要解决的就是这个问题：把粗粝的草稿内容，转换成符合统一商务排版规范的 .docx 文件。

核心能力与工作流程

技能内置一套经过验证的排版规范（v5），覆盖一份正式商务文档最需要的几个部分：

• 封面页：标题、副标题、日期、作者信息居中排列
• 多级标题体系：H1/H2/H3 自动套用深蓝主色的预设样式，不再手工刷格式
• 正文段落：首行缩进 2 字符、1.5 倍行距、两端对齐
• 表格美化：深蓝表头底 + 白字加粗、斑马纹数据行、外粗内细边框
• 页眉页脚：页眉显示文档标题，页脚显示页码

调用流程很直接：

1. 读取用户提供的 Markdown/txt/docx 内容，确认文档标题、作者等关键参数（缺失时用默认值）
2. 调用 scripts/format_doc.py，传入源内容和参数执行排版
3. 确认 exit code = 0 且输出文件存在后，通过 present_files 交付 .docx
4. 用户要求调整配色、增删章节或修改表格样式时，改参数重新执行即可

输入格式上，Markdown 的 #/##/###/#### 会映射到封面标题与三级标题，|...| 表格、列表、> 引用块都会被转换为对应样式；纯文本按连续空行分段，含 \t 的行识别为表格；已有 docx 则保留内容、整体覆盖样式。

适用边界

几点需要提前说明：

• 复杂嵌套表格（合并单元格跨行列）支持有限，建议先简化表格结构
• 暂不支持图片插入
• 公式和数学符号以纯文本呈现
• 100 页以上的超长文档，处理速度取决于本机性能

技术栈很轻：Python 3.8+ 和 python-docx，不需要安装 Office，不需要联网，也不需要任何 API Key。