前言¶

技術文檔、需求說明、合作方交付物裏，.docx 仍然很常見。要進 Git、進知識庫或交給 Coding Agent 繼續改，往往需要 Markdown。手工複製會丟標題層級、列表和行內格式；圖片要麼變成外鏈，要麼得一張張另存再補鏈接。下面介紹 SkillHub 上的 docx-to-md-with-images，它面向 Agent 場景，把文檔格式轉換寫進 Skill 工作流，重點處理 .docx 的圖片抽取與結構保留。

這是什麼¶

docx-to-md-with-images（座標 @user_29e2fa9e/docx-to-md-with-images）是 SkillHub 社區來源（community）的辦公效率類 Skill，分類爲 office-efficiency，當前版本 1.0.0，由發佈者 user_29e2fa9e 維護。標籤 requires_api_key=false，表示按 SkillHub 頁面說明，安裝與使用不依賴額外 API Key。

官方簡介：將 Word（.docx）及其他文檔格式轉換爲 Markdown；主路徑針對 .docx，強調完整圖片提取、行內格式與文檔結構保留；對 PDF、PPTX、XLSX、HTML、CSV、JSON、XML 等格式，通過 markitdown 作爲回退能力支持。

SkillHub 展示頁：https://www.skillhub.cn/skills/user_29e2fa9e/docx-to-md-with-images
API 條目：https://api.skillhub.cn/user_29e2fa9e/docx-to-md-with-images

核心功能¶

依據官方簡介，可覈實的能力如下。

1. .docx → Markdown（主路徑）
   完整抽取文檔內圖片；保留行內格式（如加粗、斜體等語義）；儘量保持原有標題、段落、列表等結構，便於後續在 Markdown 工具鏈中編輯。

2. 多格式回退
   除 Word 外，還支持 PDF、PPTX、XLSX、HTML、CSV、JSON、XML 等，通過 markitdown 回退完成轉換（能力與主路徑的「圖片 + 結構」側重可能不同，以實際轉換結果爲準）。

3. 無需 API Key
   SkillHub 標籤標明 requires_api_key=false，適合本地或內網 Agent 環境，不額外綁定第三方密鑰（仍取決於 Agent 與 Skill 包內是否聲明其他依賴，安裝後應以 SKILL.md 爲準）。

安裝與啓用¶

Skill 遵循通用 SKILL.md 格式。SkillHub 頁面給出的安裝方式是：讓 AI 按官方安裝文檔安裝該座標。

方式一：提示詞安裝（官方頁面原文）¶

將下面提示發給當前使用的 AI Agent：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_29e2fa9e/docx-to-md-with-images`。

Agent 會按 SkillHub 安裝與優先源配置 檢查 CLI、選擇正確的 skills 目錄並執行安裝。

方式二：SkillHub CLI¶

先確認是否已安裝 skillhub：

command -v skillhub && skillhub --version

未安裝時，可按官方文檔執行完整安裝（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

安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄（裝到默認 ./skills/ 可能不會被識別）。官方文檔列出的常用路徑示例：

以 Cursor 爲例，安裝命令形如：

skillhub install @user_29e2fa9e/docx-to-md-with-images --dir ~/.cursor/skills/

安裝完成後，按所用 Agent 的要求刷新或重啓，使新 Skill 被加載。

典型用法¶

公開頁面未附帶獨立 CLI 子命令說明，典型用法是：安裝並啓用 Skill 後，在對話中提供待轉換文件路徑或附件，說明需要轉爲 Markdown 並保留圖片。

可復現的安裝入口（與 SkillHub 展示頁一致）：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_29e2fa9e/docx-to-md-with-images`。

安裝完成後，可按任務描述讓 Agent 執行轉換，例如：

1. 指明輸入爲本地 .docx 文件路徑（或上傳文件）。
2. 要求輸出 Markdown，並說明圖片應抽取到相對目錄、在 .md 中用相對路徑引用。
3. 若輸入爲 PDF、PPTX 等，說明格式；Agent 將按 Skill 說明走 markitdown 回退路徑。

具體腳本名、依賴包與輸出目錄佈局以安裝包內 SKILL.md 爲準；本文不臆造未在官方資料中出現的命令行參數。

適用場景與注意¶

適合誰

• 需要把 Word 交付物批量或按需轉成 Markdown，且關心圖片與文檔結構的開發者、技術寫作者。
• 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望轉換邏輯固化在 Agent 側、減少重複提示詞的同學。

使用注意

• 主路徑與回退路徑：.docx 是能力描述中的重點；其他格式依賴 markitdown，版式複雜的幻燈片或掃描版 PDF 可能出現結構簡化或丟失，轉換後應人工抽檢。
• 安裝目錄：務必使用 skillhub install ... --dir <當前 Agent 的 skills 目錄>，避免 Skill 未被加載。
• 平臺數據：SkillHub 頁面統計會變動；撰寫時抓取的條目爲評分 100000、下載 1451、安裝 74，以 展示頁 實時數據爲準。

結尾¶

docx-to-md-with-images 把「Word → Markdown + 圖片落地 + 結構保留」收進一個可安裝的 Agent Skill，並擴展多種辦公文檔格式的 markitdown 回退。若你經常在 Agent 裏處理 .docx 歸檔或遷移，可先按官方座標安裝，再對照包內 SKILL.md 覈對依賴與輸出約定。

• SkillHub 展示頁：https://www.skillhub.cn/skills/user_29e2fa9e/docx-to-md-with-images
• API 條目：https://api.skillhub.cn/user_29e2fa9e/docx-to-md-with-images
• 安裝說明：https://skillhub.cn/install/skillhub.md