前言¶

做内容、文档和知识库相关工作的开发者，常会遇到格式转换：把 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