前言¶
把 PDF 变成可读的文本，常见做法是直接调用转换工具或让模型读截图。前者常常把版面顺序打乱、丢掉表格和标题层级，后者对长文档成本高、效果不稳定。下面介绍的这个 Skill 面向开发者的工作流，把「PDF 转 Markdown」封装成一个可复用的步骤：输入 PDF，输出结构化 Markdown，关键信息保留，并支持自定义格式输出。
这是什么¶
这是 SkillHub 社区上的一个 Skill，坐标为 @user_a10ab3ad/markdown-themeable-pdf，名称「PDF文档 智能提取 格式转换」，当前版本 1.0.1，由用户 user_a10ab3ad 发布，分类为 office-efficiency，来源标记为 community。
它解决的问题是：拿到一份 PDF（报告、文档、扫描件文本层），需要把正文转成结构化的 Markdown 供后续处理，而不是手工复制粘贴或维护一套临时脚本。
核心功能¶
根据官方简介，它提供的能力有三项：
- 将 PDF 文件高效转换为结构化 Markdown。
- 转换过程中保留关键信息，例如标题、正文段落、列表、表格等结构元素。
- 支持自定义格式输出，即可以在转换时指定希望的 Markdown 组织方式。
标签 requires_api_key=false，表示该 Skill 不需要配置 API Key 即可使用。
安装与启用¶
官方页面给出的安装方式需要以该页面为准。已抓取的资料中未包含具体的安装命令或目录路径，这里不臆造。获取方式如下：
- 打开官方地址：https://api.skillhub.cn/user_a10ab3ad/markdown-themeable-pdf
- 在页面上查看安装命令与启用说明。
- 按说明把 Skill 加入你的 Agent（Cursor、Codex CLI、Claude Code 等）后再调用。
当前资料中没有区分各编辑器的安装差异，因此不做分别说明。安装前建议先在页面确认版本号与命令是否与本文档记录的版本一致。
典型用法¶
官方简介给出的用法是：提供一份 PDF 文件，让 Skill 执行转换，得到结构化 Markdown。如果需要自定义格式，按 Skill 支持的方式指定输出格式要求。
需要说明的是，官方页面未提供可直接复制的示例命令，因此本文不给出虚构示例。在启用 Skill 后，最直接的验证方式是拿一份结构清晰的 PDF 试跑一次，检查输出的 Markdown 是否保留了标题层级和表格结构。
适用场景与注意¶
适合的场景：
- 需要把一批 PDF 文档批量转成 Markdown 再入库或索引的开发者。
- 想把 PDF 内容交给模型处理，但希望先得到干净的 Markdown 而非直接喂 PDF 的场景。
- 对输出格式有要求，希望自定义 Markdown 组织方式的场景。
需要注意的限制：
- 转换质量依赖 PDF 自身的文本层。扫描件没有文本层时，效果取决于其内部使用的文字提取方式，建议先拿样例验证。
- 资料中未列出该 Skill 对表格、公式、图片等复杂元素的处理细节，使用前应以官方页面说明和实测为准。
- 页面显示安装数为 0，属于较新的社区 Skill，使用前留意版本更新。
结尾¶
这个 Skill 的价值在于把「PDF 转结构化 Markdown」变成一步调用，免去自建转换脚本的成本，同时支持自定义输出格式。官方地址：https://api.skillhub.cn/user_a10ab3ad/markdown-themeable-pdf
