前言¶
技术文档、论文和合同常以 PDF 分发，其中不少是扫描件或内嵌图片，无法直接复制文字。手工 OCR 再排版成 Markdown 成本高，通用「读 PDF」能力对表格、公式和多语言混排往往力不从心。下面介绍 SkillHub 上的社区技能 pdf文档转markdown（坐标 @user_3afb9517/pdf-scan-to-md），面向「把 PDF（含扫描件、图片页）转成可编辑 Markdown」这一具体需求。
这是什么¶
pdf文档转markdown 是一条基于通用 SKILL.md 格式的 Agent Skill，发布在 SkillHub，分类为 office-efficiency，来源为社区（发布者 user_3afb9517），当前版本 1.0.1。
官方简介将其定位为：将 PDF 文件（含扫描件、图片）转换为 Markdown；接入 MinerU 与 PaddleOCR 双引擎，支持扫描件 OCR、公式与表格解析、多语言识别，并兼容本地 OCR。Skill 标签标明 requires_api_key=true，使用前需按技能说明准备相应 API 或本地 OCR 环境（页面未展开具体密钥字段名，以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，未单独列出的不做延伸：
- PDF → Markdown：输出 Markdown，便于后续检索、版本管理和在编辑器中修改。
- 扫描件与图片页：通过 OCR 路径处理非可选中文本的 PDF。
- 双引擎：MinerU 与 PaddleOCR 分工由技能内部实现；用户侧主要选择文件与触发转换流程。
- 公式与表格：支持公式、表格的解析（具体效果取决于 PDF 质量与引擎能力）。
- 多语言：支持多语言识别场景。
- 本地 OCR：简介写明兼容本地 OCR，适合不便走云端或需离线处理的场景。
安装与启用¶
SkillHub 页面给出的安装指引是：根据 SkillHub 安装文档 安装坐标 @user_3afb9517/pdf-scan-to-md。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档推荐）：
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
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。文档记载的常见路径如下：
| Agent / 客户端 | skills 目录（示例） |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中，可先搜索再安装到对应目录（将 <skills 目录> 换成上表路径）：
skillhub search pdf-scan-to-md
skillhub install user_3afb9517/pdf-scan-to-md --dir ~/.cursor/skills/
坐标写法以 SkillHub 页面为准：@user_3afb9517/pdf-scan-to-md；CLI 安装时通常使用 user_3afb9517/pdf-scan-to-md 形式（与 skillhub install 示例一致）。
3、启用与 API¶
- 标签
requires_api_key=true表示部分能力可能依赖外部或本地服务密钥，安装后阅读技能包内 SKILL.md 完成配置。 - 安装或更新 skills 后，按你所用 Agent 的要求重启或重新加载会话，使技能被发现。
官方页面亦提供「将提示词发送给你的 AI 安装该 skills」的文案，内容与上述安装文档链接一致，适合直接交给 Agent 执行安装步骤。
典型用法¶
公开页面未给出逐条 shell 示例，标准用法是：在已安装技能的 Agent 中，指明待转换的 PDF 路径或文件，请求按技能流程输出 Markdown。例如向 Cursor 说明本地 PDF 路径，并说明是否为扫描件，由 Agent 调用技能内定义的 MinerU / PaddleOCR 或本地 OCR 流程。
复现路径建议：
- 按上一节完成
skillhub install与 skills 目录配置。 - 在对话中引用
@user_3afb9517/pdf-scan-to-md或依赖自动发现的 skill 名称 pdf文档转markdown。 - 提供 PDF 文件；若技能文档要求 API Key 或本地 OCR 依赖，先按 SKILL.md 配置后再转换。
具体参数、输出路径与引擎切换方式以安装包内 SKILL.md 为准；本文不编造未在官方摘要中出现的配置项名。
适用场景与注意¶
适合谁
- 需要把论文、说明书、扫描合同等 PDF 变成 Markdown 的开发者或文档维护者。
- 文档含表格、公式或多语言，希望借助 MinerU / PaddleOCR 做结构化提取，而不是纯文本抽取。
- 有本地 OCR 或合规要求，希望走「兼容本地 OCR」路径的团队。
限制与注意
- 社区来源（
community），质量与维护节奏依赖发布者；升级可用skillhub在相同--dir下更新。 - OCR 与版面分析对扫描清晰度、倾斜、水印敏感，复杂版式需人工校对。
requires_api_key=true：未配置密钥时部分云端能力可能不可用，应优先核对 SKILL.md。- SkillHub 元数据（截至抓取）：评分 100000，下载 976；页面统计会变动，以 SkillHub 技能页 为准。
结尾¶
pdf文档转markdown 把「PDF / 扫描件 → Markdown」收拢为一条可安装的 Agent Skill，双引擎 OCR 与公式表格、多语言、本地 OCR 等能力在官方简介中均有交代。若你的工作流里频繁遇到不可复制的 PDF，可按 SkillHub 文档安装 @user_3afb9517/pdf-scan-to-md，并在 Agent 中直接发起转换。
- SkillHub 页面：https://www.skillhub.cn/skills/user_3afb9517/pdf-scan-to-md
- API / 元数据入口：https://api.skillhub.cn/user_3afb9517/pdf-scan-to-md
- 安装说明：https://skillhub.cn/install/skillhub.md
