前言¶
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 或 目錄頁。