前言¶
DSH Agent 在交付文档时，常需将 Markdown 转换为可编辑的 Word 文档。手动处理中文排版、Mermaid 图表截图或 LaTeX 公式录入效率低下。bruce-md2word 是一个插件，提供本地转换能力，将 Markdown 直接交付为标准 Word 文档。
简介¶
名称：bruce-md2word
一句话介绍：面向 AI Agent 的 Markdown 转 Word 工具：中文排版、Mermaid 图表转图片、可编辑数学公式。
所有者：bruc3van
类别：工作流
Star 数：3
许可证：MIT
核心功能¶
- 中文排版：支持 A4 页面，正文使用宋体/黑体，自动处理标题、列表和表格。
- Mermaid 图表转图片：支持流程图、时序图、状态图、ER 图等，将图表渲染为图片并嵌入 Word，支持中文标签。
- LaTeX 数学公式转 Word 原生公式：支持分式、根式、矩阵等，转换后可在 Word 中继续编辑。
安装与启用¶
请从 npm 安装 DSH 插件 bruce-md2word：
npm install bruce-md2word
安装后，Agent 可通过 word_export 工具直接调用。
使用方式¶
提供三种使用方式：
- DSH 插件：通过
word_export工具调用。 - 独立 CLI：安装全局 CLI 后，使用命令行导出。
- Skill：独立的技能文件，供具备命令执行能力的 Agent 调用。
运行环境与依赖¶
- Node.js 版本：需要 24 或 26。
- 中文字体：需安装中文字体以渲染图表。
- 运行方式：本地转换，不上传文档，不调用大模型 API。
适用场景与注意¶
- 适用场景：项目报告、实施方案、会议纪要、技术说明等结构化文档。
- 严格模式：使用
--strict参数，拒绝保存内容降级的文档。 - 安全：转换过程在本地完成，不上传文件，不使用 API Key。
结尾¶
bruce-md2word 通过本地解析和渲染，解决了 Agent 交付文档时的排版和公式难题。更多详情可访问 GitHub 或 目录页。
