前言¶

寫技術文檔時，團隊裏常見兩套稿：開發用 Markdown 維護，對外或走審批用 Word。手工互拷格式、表格和代碼塊，既慢又容易丟樣式。合併單元格、Mermaid 圖、中文段落排版，在兩種格式之間尤其難對齊。

下面介紹 SkillHub 上的社區 Skill markdown轉word（座標 @user_27f88699/md2docx），把「Markdown ↔ Word」的轉換交給當前 Agent 執行，並針對表格合併、圖表與中文排版做了能力說明。

這是什麼¶

markdown轉word 是 SkillHub 分類 office-efficiency 下的社區 Skill，發佈者爲 user_27f88699，當前頁面標註版本 v2.0.0，來源爲 community。官方簡介概括爲：Markdown 與 Word 雙向轉換，並支持合併單元格（rowspan/colspan）、Mermaid 圖表渲染、代碼高亮、中文排版優化。

頁面標籤標明 requires_api_key=false，即安裝後使用不依賴額外 API Key。SkillHub 展示頁上的統計（以頁面抓取爲準）爲評分 100000、下載 8004、安裝 38。

• Skill 展示頁：https://www.skillhub.cn/skills/user_27f88699/md2docx
• 官方座標鏈接：https://api.skillhub.cn/user_27f88699/md2docx

核心功能¶

以下能力均來自 SkillHub 官方簡介，未在資料中出現的細節不展開：

1. 雙向轉換：Markdown 轉 Word，以及 Word 轉 Markdown（具體執行方式由 Skill 包內 SKILL.md 指導 Agent，安裝後向 Agent 說明源文件與目標格式即可）。
2. 表格合併單元格：支持 rowspan、colspan，適合複雜表頭的需求文檔或測試矩陣。
3. Mermaid 圖表：可將文檔中的 Mermaid 源碼渲染進 Word 輸出（與純文本粘貼相比，減少手工製圖）。
4. 代碼高亮：保留或生成帶高亮樣式的代碼塊，便於技術說明類文檔。
5. 中文排版優化：針對中文文檔的常見排版問題做處理，減輕 Word 與 Markdown 互轉後的版式錯亂。

安裝與啓用¶

SkillHub 推薦通過 skillhub CLI 安裝，並必須把技能裝到當前 Agent 能識別的 skills 目錄，否則默認落在 ./skills/ 且可能不被加載。

1、安裝 skillhub CLI（若尚未安裝）¶

先檢查是否已安裝：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅需 CLI 時：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

完整說明見：https://skillhub.cn/install/skillhub.md

2、安裝本 Skill¶

SkillHub 頁面給出的安裝提示爲：根據上述安裝文檔，安裝 @user_27f88699/md2docx。對應 CLI 形式爲將技能裝到當前環境的 skills 目錄（--dir 必填）：

skillhub install user_27f88699/md2docx --dir <skills 目錄>

常用 Agent 的 skills 路徑（摘自 SkillHub 安裝文檔）：

安裝後按你所用客戶端要求重啓或重載 Agent，使新 Skill 生效。

也可將下面提示詞發給 AI，由其按官方文檔完成安裝（與 SkillHub 頁面文案一致）：

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_27f88699/md2docx。

典型用法¶

公開頁面未附帶獨立的命令行示例腳本；標準路徑是：安裝 Skill → 在對話中說明轉換方向與文件路徑 → 由 Agent 按 Skill 指令完成轉換。

可操作的起步方式：

1. 確認 markdown轉word 已出現在當前 Agent 的 skills 目錄中。
2. 在對話中明確需求，例如：將某份 .md 轉爲 .docx，或把 .docx 抽成 Markdown；若文檔含合併單元格表格、Mermaid 代碼塊或中文長文，在提示裏一併說明，以便對齊 Skill 簡介中的能力範圍。
3. 檢查輸出文件的表格、圖表與代碼塊是否符合預期；複雜版式仍可能需要人工微調。

搜索技能時，也可使用：

skillhub search md2docx

適用場景與注意¶

適合誰

• 經常用 Cursor、Claude Code 等帶 Skills 的 Agent 寫文檔，需要在 Markdown 與 Word 之間來回交付的人。
• 文檔裏表格較多、需要 rowspan/colspan，或內含 Mermaid、代碼塊的技術說明、方案稿。

注意

• 本 Skill 爲 community 來源，行爲以安裝包內說明爲準；升級前留意 SkillHub 上的版本號（當前爲 2.0.0）。
• 安裝務必使用 skillhub install ... --dir <skills 目錄>，路徑錯誤會導致 Agent 無法加載。
• 雙向轉換與複雜版式無法保證與手工排版完全一致，正式對外文檔建議保留一次人工校對。
• 資料中未提供獨立服務 SLA；轉換在本地 Agent 會話中完成，大文件或極複雜版式需自行驗證耗時與結果。

結尾¶

markdown轉word 把 Markdown 與 Word 的雙向轉換、表格合併、Mermaid、代碼高亮和中文排版優化收斂到一個 SkillHub 技能裏，適合掛在日常寫文檔的 Agent 上使用。安裝與目錄配置以 SkillHub 官方文檔爲準。

• Skill 頁：https://www.skillhub.cn/skills/user_27f88699/md2docx
• 安裝說明：https://skillhub.cn/install/skillhub.md