前言¶

处理 PDF 的常见路径是先找转换工具，再把结果粘进笔记。文本型 PDF 勉强可行，扫描件就直接失败；转换后的文字也往往带着断行、错位表格和缺失的图片，还得手工重排。

下面介绍的 Skill「PDF转MD」把这件事收进一个流程里：读取 PDF，理解内容，输出结构化 Markdown。它是发布在 SkillHub 上的一个 SKILL，坐标 @org-rn88lg3j/pdf-md，发布者小笨羊科技，来源 enterprise，分类 office-efficiency，当前版本 1.0.1。据 SkillHub 页面抓取资料，评分 100000，下载 1809，安装 0。

这是什么¶

一句话定位：把 PDF 文件内容抽取为结构化 Markdown 知识文档的 Skill，同时支持文本型 PDF 和扫描件 OCR。

它解决的是从「PDF 里的原始内容」到「可读、可检索、可归档的知识文档」之间的抽取与整理工作，而不是只做一次格式转换。

核心功能¶

据官方简介，能力分四步：

1. 自动检测当前 agent 的 PDF 读取能力。
2. 优先使用原生 PDF 阅读（视觉理解）；备选使用 Python 库 PyMuPDF / pdfplumber 提取文本和图片，并对图片做 OCR 文字提取。
3. 在读取结果之上理解内容，做知识抽取整理。
4. 严格格式化输出 Markdown。

触发词：PDF知识抽取、提取笔记、整理PDF、转MD，知识整理、扫描件OCR。

安装与启用¶

本次抓取到的资料中没有给出安装命令、目录或配置项，只确认了以下事实：

• 坐标：@org-rn88lg3j/pdf-md
• 官方页面：https://www.skillhub.cn/skills/org-rn88lg3j/pdf-md
• 接口地址：https://api.skillhub.cn/org-rn88lg3j/pdf-md
• 标签中带有 requires_api_key=true，说明该 Skill 需要 API Key
• 它遵循通用 SKILL.md 格式，按 SkillHub 的分发方式安装后，由 agent 在命中触发词时调用

因此这里不写安装命令。请到官方页面按其引导获取，不要照抄第三方示例。

典型用法¶

资料中没有提供可复现的输入输出示例。可直接依据触发词描述用法：把 PDF 交给 agent，并用触发词表达意图，例如「整理PDF，转MD」「提取笔记」「扫描件OCR」。

流程上先做读取，再做理解与抽取，最后做格式化输出：

PDF 文件 -> 读取（原生视觉 或 PyMuPDF/pdfplumber + OCR）-> 理解与知识抽取 -> Markdown 输出

具体输出样式取决于 agent 侧对该 SKILL 的执行结果，资料未给出样例，这里不做推测。

适用场景与注意¶

适合的场景：

• 需要把一批 PDF 归档成统一结构的 Markdown 知识文档
• 文本型 PDF，直接提取文本即可
• 扫描件，依赖图片 OCR 后再理解

需要注意的限制与坑：

• 需要 API Key，标签 requires_api_key=true
• 能力分两条路径：原生 PDF 阅读（视觉理解）优先，Python 库备选。实际走哪条取决于当前 agent 的 PDF 读取能力，转换效果也会有差异
• 扫描件的效果受 OCR 质量影响，表格、公式、复杂版式的还原程度没有资料可保证
• 资料未提供输出样例、配置项和安装方式，落地前需要先到官方页面确认

结尾¶

这个 Skill 的价值在于把「读取 PDF + OCR + 理解 + 整理成 Markdown」串成一条链路，减少手工转换与重排。适用边界也很明确：需要 API Key，效果随读取路径和 PDF 类型变化。

官方地址：https://www.skillhub.cn/skills/org-rn88lg3j/pdf-md