已经用 Markdown 写稿，想让 AI Agent 或命令行把报告、方案交付为 Word 的人。
拿到可继续编辑的 DOCX、实际文件路径和转换警告，再用 Word 或 WPS 检查后交付。
Markdown 写好了，怎样交付成 Word？
bruce-md2word 面向已经用 Markdown 写好的报告、方案、会议纪要和技术说明。它将正文、标题、列表和表格转换成可编辑的 Word 内容，提供中文排版预设，并把 Mermaid 图表与 LaTeX 公式一起处理，减少复制到 Word 后重新整理格式的工作。
它既能由具备命令执行能力的 AI Agent 通过 Skill 调用，也能直接在命令行使用；DSH 用户可以安装插件，通过 word_export 导出。三种入口使用同一转换引擎。
中文排版、图表和公式分别怎么处理？
| 内容 | 导出结果 | 交付前检查 |
|---|---|---|
| 中文正文、标题、列表和表格 | A4 页面与中文排版预设，文字和表格可编辑 | 字体、分页和表格列宽 |
| Mermaid 图表 | 在运行机器上渲染为 PNG 并嵌入 | 中文字体、图中文字大小与布局 |
| LaTeX 数学公式 | 转换为 Word 原生公式，可继续编辑 | 复杂公式是否完整、有无转换警告 |
图表图片和可编辑公式是两种不同的结果。需要修改图表节点时，应修改原始 Mermaid，再重新导出。可以在仓库的导出效果示例中查看中文排版、图表与公式的成品截图和 Markdown 源文件。
Markdown 与 Word 成品效果对比
bruce-md2word 的三组示例分别展示中文排版、Mermaid 图表和数学公式。左侧是对应 Markdown 的节选，右侧是实际导出的 Word 第 1 页；手机端按输入、输出顺序排列。点击图片可查看大图。
截图由项目作者于 2026-09-22 在 Windows 上使用 Microsoft Word 原生渲染、officecli 截取，采用默认样式，未手工调整 Word 排版。以下图片是仓库原图的 WebP 压缩版；截图生成说明与复现命令保留了原始记录。这三份展示样例与下方 31 KB 测评样本不同。
分级标题、列表和表格如何保留？
中文 Markdown 中的标题层级、任务列表和表格，在 Word 成品中呈现为分级标题、项目符号和有表头的表格。示例内容为虚构项目。
输入 · Markdown 节选
# 项目进展报告
## 一、阶段成果
### 1. 内容组织
- 按背景、进展、问题和计划组织报告。
- 使用分级标题呈现层次，突出关键结论。
### 2. 任务进展
| 工作事项 | 当前状态 | 下一步安排 |
| --- | --- | --- |
| 需求梳理 | 已完成 | 确认验收范围 |
Mermaid 代码怎样变成 Word 图表？
流程图中的判断分支、中文标签和连接关系被渲染为图片，时序图展示用户、Agent 与导出工具的交互。修改节点时需要编辑 Mermaid 源码后重新导出。
输入 · Markdown 节选
```mermaid
flowchart LR
A[整理资料] --> B{资料完整？}
B -->|是| C[交付报告]
B -->|补充| A
```
LaTeX 公式导出后是什么样？
分式、求和、积分、矩阵和中文分段条件以数学排版显示。项目说明其输出为 Word 原生公式；截图只能展示外观，是否可编辑仍应打开 DOCX 验证。
输入 · Markdown 节选
$$
x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
$$
$$
\sum_{i=1}^{n}i=\frac{n(n+1)}{2}
$$
同一份复杂 Markdown，三种 Skill 的效果如何？
以下为项目作者在 README 中公布的单次转换记录：同一份约 31 KB Markdown，包含标题、表格、六类 Mermaid 图和 6 个公式，每个 Skill 各运行一次。耗时是当次任务全流程时间，并非转换引擎基准测试；bruce-md2word 的时间包含首次安装 CLI。
| 本次使用的 Skill | README 记录的成品表现 | 全流程用时 | 本次限制与问题 |
|---|---|---|---|
| bruce-md2word | 标题、表格和六类图的结构与布局保留较完整；6 个公式为可编辑 Word 公式 | 148.3 秒 | 两张图缩小后文字偏小，31 页成品有部分留白 |
| documents:documents（Codex） | 主要文字、表格和普通图片可用；Mermaid 保留节点与关系文字，但未还原方向和布局 | 381.8 秒 | 临时编写 Python 转换与制图代码；缺少 soffice.exe，规定的渲染验收未完成；部分公式结构简化 |
| docx（Anthropic） | 有动态目录和原生脚注；普通图片与表格大体可用，Mermaid 布局未还原 | 312.8 秒 | 临时编写并调试 JavaScript；初始文件经 Word 修复另存，块公式和表格内图片仍有缺陷 |
如何解读： 这份记录反映专用 Markdown 转换工具与两种通用 Word 制作 Skill 在一个样本上的表现。通用 Skill 的结果取决于 Agent 临时编写的脚本，不代表其在其他任务中的上限；也不能据此推导普遍速度排名。
来源：项目 README 的单次实际转换测评，本页于 2026-10-03 整理。该公开记录未列出完整测试硬件、模型、Skill 版本和原始计时日志，本页未独立复测，也不据此计算提速比例或作独立评测背书。
选择哪种使用方式？
| 你的工作方式 | 入口 | 需要准备什么 |
|---|---|---|
| 让 AI Agent 写稿并交付 Word | Skill + CLI | 支持命令执行的 Agent，以及 Node.js 24 或 26 |
| 自己在终端导出，或接入脚本 | 独立 CLI | Node.js 24 或 26 和包管理器 |
| 已经在使用 DeepSeek Harness | DSH 插件 | 按当前项目说明确认宿主兼容范围及服务要求 |
独立 CLI 不需要启动 DSH。依赖安装后，转换不要求 Office、Python、浏览器或在线转换服务；中文图表需要运行机器具备中文字体。最新环境要求和安装命令以项目仓库为准。
第一份文档怎么导出？
先按仓库说明安装 Skill 或 CLI，再准备一份 Markdown 和它引用的本地图片。已安装 CLI 时，可以运行：
bruce-md2word docs/报告.md --strict -o output/项目报告.docx也可以把下面的要求交给 Agent：
请使用 bruce-md2word 将 docs/报告.md 严格导出为 Word，返回实际文件路径和所有警告；如果导出失败，先说明错误与需要修正的内容，不要把未生成的文件当作交付结果。
成功时，CLI 返回包含实际路径和警告的 JSON。同名文件会自动编号，所以要使用返回的路径，而不是猜测文件名。显式指定输出目录时，父目录需要存在。文件保存在执行 CLI 或 DSH 服务的机器上；使用云端 Agent 时，不一定在你的电脑上。
严格模式通过，就能直接交付吗？
还需要打开成品检查。--strict 会拒绝保存检测到内容降级的文档，例如图片缺失或不支持的图表语法；通过只表示没有检测到这类降级。事实、引用、实际分页和图表可读性仍需人工核对。
Mermaid 支持部分图表类型的常用语法，不覆盖全部语法；网络图片不会自动下载，SVG 图片输入不受支持。遇到警告时，先修正 Markdown、图片路径或图表，再重新导出，保留原始稿件方便后续修改。
文档会上传到哪里？
默认 CLI 和 DSH 项目模式在运行它们的机器上完成转换，不调用大模型 API，也不需要转换服务的 API Key。安装与更新依赖时会访问软件源。如果 Agent 本身在云端生成或读取文档，其数据处理仍受对应平台规则约束，不能把“转换在本地运行”理解为整个 Agent 工作流都不联网。
和另外几个文档工具怎么选？
- 已有 Markdown，需要中文排版、图表和公式的 Word 成品：使用 bruce-md2word。
- 在浏览器里直接保存 AI 对话：看 Chat2Word。
- 先把 Office 或 PDF 资料转成 Markdown：看编辑器扩展 DocuGenius 或命令行工具 Bruce Doc Converter。
从整理资料到写稿、核对和交付的完整流程，见 AI 文档写作与导出。
项目文档和注意事项
内容更新：。正文依据上方 README 的固定提交整理；内容更新日期不代表已核验最新版本。最新版本和安装要求请看项目仓库。
注意：Mermaid 图表嵌入为图片，不能在 Word 中直接编辑节点；公式转换为 Word 原生公式。严格模式检查转换完整性，不代表事实正确或排版已验收，不提供自定义 Word 模板接口。