前言¶
做內容、文檔和知識庫相關工作的開發者，常會遇到格式轉換：把 Markdown 轉成 DOCX 給協作者，把 RST 或 AsciiDoc 轉成 HTML 發佈，把 ipynb 導出成 PDF 歸檔，或反過來把 ODT、RTF 讀回 Markdown 再處理。手動跑 Pandoc 需要記參數，批量文件要寫腳本，PDF 還要額外配引擎。當這類轉換髮生在 Agent 對話裏時，問題更具體：Agent 需要知道什麼時候該轉換、轉什麼格式、用什麼參數、缺引擎時怎麼排查。
下面介紹的 pandoc-convert 就是一個圍繞這件事的 Skill。
這是什麼¶
pandoc-convert 是一個面向通用 SKILL.md 格式的 Skill，作用是讓 Agent 在用戶需要做文檔格式轉換時，按 Pandoc 的參數體系完成轉換，包括格式選擇、批量處理、引用、模板、目錄生成，以及 Pandoc 安裝和 PDF 引擎排查。
它由 user_cea1fb81 發佈在 SkillHub，座標爲 @user_cea1fb81/pandoc-convert-pro，當前版本 1.0.0，來源爲 community，分類是 office-efficiency。Skill 標籤顯示 requires_api_key=false，即不需要額外 API key 即可使用。SkillHub 頁面顯示評分 100000，下載 974，安裝 0。
核心能力¶
根據 SkillHub 上該 Skill 的官方簡介，它的觸發範圍覆蓋以下幾類需求：
1、格式轉換。支持 Markdown、DOCX、PDF、HTML、EPUB、LaTeX、Typst、RST、AsciiDoc、Org、ODT、RTF、ipynb 之間的相互轉換。
2、單文件轉換。針對一個輸入文件指定目標格式並輸出。
3、批量轉換。對一批文檔統一處理格式，減少重複命令操作。
4、引用與參考文獻。處理 citations，即 Pandoc 的文獻引用與參考文獻生成。
5、模板。使用自定義模板控制輸出樣式。
6、目錄。生成或調整 table of contents。
7、Pandoc 安裝協助。當環境裏沒有 Pandoc 時，幫助完成安裝。
8、PDF 引擎排查。PDF 生成依賴外部引擎，當轉換 PDF 失敗時幫助定位引擎問題。
安裝與啓用¶
官方資料中未提供可直接複製的安裝命令或目錄路徑，也沒有 Cursor、Codex CLI、Claude Code 之間的差異說明。能用的事實只有座標與來源：
座標：@user_cea1fb81/pandoc-convert-pro
來源：community
分類：office-efficiency
標籤：requires_api_key=false
如果需要確認具體安裝步驟，應打開官方地址查看當前頁面的說明，不要憑經驗假設。官方地址見文末。
典型用法¶
Skill 本身不改變 Pandoc 的命令用法，它的價值在於讓 Agent 判斷何時需要轉換、選擇目標格式、並正確組織參數。下面列出 Pandoc 本身常見的轉換寫法，作爲理解 Skill 能力邊界的參考。這些命令需要在環境已安裝 Pandoc 的前提下執行。
單文件 Markdown 轉 DOCX：
pandoc input.md -o output.docx
Markdown 轉 HTML 並生成目錄：
pandoc input.md -o output.html --toc
Markdown 轉 PDF：
pandoc input.md -o output.pdf
這條命令依賴 PDF 引擎，如 pdflatex、xelatex、wkhtmltopdf 或 weasyprint。如果環境裏沒配引擎，會報缺引擎的錯誤，對應 Skill 簡介裏的 PDF engine troubleshooting。
批量轉換目錄下所有 Markdown 爲 HTML：
for f in *.md; do pandoc "$f" -o "${f%.md}.html"; done
使用自定義模板：
pandoc input.md -o output.docx --template=custom.docx
引用和參考文獻：
pandoc input.md -o output.pdf --citeproc --bibliography=refs.bib
上面這些命令是 Pandoc 的常規用法。Skill 的作用是讓 Agent 在對話中根據用戶意圖選擇對應命令和參數，而不是把命令清單硬塞給用戶。
適用場景與注意¶
適合以下場景：
1、Agent 對話中出現明確的格式轉換需求，例如「把這個 Markdown 轉成 Word」或「把 RST 批量轉成 HTML」。
2、需要生成目錄、引用或自定義模板的轉換任務。
3、環境中尚未安裝 Pandoc，需要先協助安裝。
4、轉換 PDF 時遇到引擎報錯，需要排查是缺引擎還是參數問題。
需要注意的限制：
1、Skill 來源是 community，不是官方 Pandoc 項目出品。它調用的是 Pandoc 的能力，不等於 Pandoc 本身有官方 Skill。
2、當前安裝量爲 0，說明它還不是廣泛使用的成熟包，使用前建議先在小任務上驗證。
3、PDF 轉換依賴外部引擎，LaTeX 系引擎體積大、安裝時間長；純 HTML 轉 PDF 可用 weasyprint 或 wkhtmltopdf，體積相對小。具體引擎選擇要結合目標語言和字符集。
4、複雜排版、中文字體、表格跨頁、圖片縮放等場景，Pandoc 默認輸出可能不滿足要求，需要額外調模板或後處理。
5、Skill 簡介未說明對 ODT、RTF 等格式的讀寫細節，也沒有說明批量轉換的具體上限，實際行爲應以當前 Skill 頁面爲準。
結尾¶
pandoc-convert 的價值在於把「判斷什麼時候該轉換」和「怎麼寫 Pandoc 參數」這兩件事交給 Agent 處理，減少手動記命令和寫批處理腳本的成本。它覆蓋的格式較全，從 Markdown、DOCX、HTML 到 EPUB、LaTeX、Typst、RST、AsciiDoc、Org、ODT、RTF、ipynb 都在範圍內，並且包含引用、模板、目錄和 PDF 引擎排查。
官方地址：
https://api.skillhub.cn/user_cea1fb81/pandoc-convert-pro
SkillHub 頁面：
https://www.skillhub.cn/skills/user_cea1fb81/pandoc-convert-pro
