前言¶
课程讲义、扫描手写笔记、会议 PDF 往往页数多、版式杂。人工复制粘贴容易丢层级，直接让模型「读 PDF」又受 Agent 是否支持原生 PDF、文件是文本层还是纯图片影响。下面介绍 SkillHub 上的 Pdf To Markdown Knowledge（坐标 @user_bbd16bf9/pdf-to-knowledge，当前版本 1.0.3）：在 Agent 侧按能力自动选路径，把 PDF 内容整理成可复用的 Markdown 知识文档，并注明可进一步导入思维导图。
这是什么¶
Pdf To Markdown Knowledge 是社区来源（community）的知识管理类 Skill，发布者为 user_bbd16bf9，分类为 knowledge-management。标签 requires_api_key=false，不依赖额外 API Key 配置。
它解决的是：从 PDF 笔记中抽取要点、结构化输出 Markdown，而不是只返回原始全文粘贴。
核心功能¶
依据 SkillHub 页面与 API 资料，已核实能力如下。
- 输入类型：支持文本型 PDF；扫描件可走 OCR 链路。
- 读取策略：自动检测当前 Agent 的 PDF 读取能力；优先使用原生 PDF 阅读（含视觉理解）；若不可用，备选 Python 库 PyMuPDF、pdfplumber、Tesseract OCR 提取文本与图片，再对内容做理解与知识整理。
- 输出：严格格式化的 Markdown 知识整理文档；页面说明最终 Markdown 可以导入为思维导图。
- 触发词（在对话中唤起 Skill 时可使用）：
PDF知识抽取、提取笔记、整理PDF、知识整理、扫描件OCR。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 1047 次。
安装与启用¶
官方安装方式是通过提示词让 AI 按 SkillHub 安装文档执行，坐标固定为 @user_bbd16bf9/pdf-to-knowledge。
将下面提示发给当前使用的 AI（Cursor、Codex CLI、Claude Code 等，具体目录与命令以安装文档为准）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bbd16bf9/pdf-to-knowledge`。
安装说明全文在 skillhub.cn/install/skillhub.md。不同客户端的步骤以该文档为准；本文不展开未在官方页面单独列出的差异配置。
Skill 资源入口：
- API / 安装页：https://api.skillhub.cn/user_bbd16bf9/pdf-to-knowledge
- SkillHub 展示页：https://www.skillhub.cn/skills/user_bbd16bf9/pdf-to-knowledge
典型用法¶
官方页面未给出单独的多步 CLI 示例，典型流程是对话驱动：
- 完成上述安装，确保 Skill 已加载。
- 在 Agent 中附上或指定待整理的 PDF 文件路径。
- 使用触发词发起任务，例如：
整理PDF：把这份课程笔记 PDF 做成结构化 Markdown 知识文档，保留章节层级和要点列表。
或针对扫描件：
扫描件OCR：这是扫描版笔记 PDF，请 OCR 后做知识整理，输出 Markdown。
- Agent 按 Skill 逻辑选择原生阅读或 Python/OCR 备选路径，输出 Markdown 文件或可直接保存的正文。
若你的环境缺少 Tesseract 或相关 Python 库，备选路径可能失败；此时应优先使用支持原生 PDF 阅读的 Agent，或在本机补齐依赖后再试（具体依赖以 Skill 内 SKILL.md 为准）。
适用场景与注意¶
适合谁
- 需要把 PDF 讲义、读书笔记、培训材料沉淀为 Markdown 笔记库的人。
- 希望输出结构清晰、便于导入思维导图工具的读者。
- 文档可能是扫描件、不能指望直接复制文本层的场景。
限制与注意
- 抽取质量取决于 PDF 清晰度、版式复杂度，以及 Agent 是否具备视觉理解或 OCR 环境。
- 社区 Skill，行为以
SKILL.md与安装后 Agent 实际能力为准；大页数 PDF 可能耗时较长。 - 不涉及
requires_api_key，但若备选方案调用本机 OCR，需自行安装 Tesseract 等组件。
结尾¶
Pdf To Markdown Knowledge 把「读 PDF」和「写成结构化知识」绑成一条 Skill 流程：自动适配 Agent 能力，文本 PDF 与扫描件有备选提取路径，输出面向后续笔记与思维导图复用。需要安装或查看说明时，请打开官方地址：https://api.skillhub.cn/user_bbd16bf9/pdf-to-knowledge，或 SkillHub 页面：https://www.skillhub.cn/skills/user_bbd16bf9/pdf-to-knowledge。
