# PDF 转 Markdown

从 PDF 中恢复可读的 Markdown、公式和图片，用于笔记、评审或复用。

PDF 转 Markdown 能从固定的页面中取出有用的阅读材料。你可以用它把自己的报告变成笔记，把文档整理进 Markdown 知识库，或恢复已经没有可编辑源码的文字。

## 何时选它

当你想要可移植的正文和简单的结构时，请使用 Markdown。如果目标是排版好的论文，请选择 [PDF 转 LaTeX](/docs/tools/pdf-to-latex/)；如果你打算继续用 Typst，请选择 [PDF 转 Typst](/docs/tools/pdf-to-typst/)。

只转换你拥有或获许复用的文档。转换不会改变来源的版权或许可。

## 转换 PDF

1. 打开 **PDF 转 Markdown**，或运行 `/pdf-to-markdown`。
2. 选择不超过 128 MB 的 PDF。
3. 开始转换。
4. 保存 `converted.md` 以及提取出的所有文件，或创建 Markdown 项目。
5. 把结果与 PDF 对照检查。

对于带可选中文字的 PDF，Oleafly 会读取文字层，识别疑似的标题和分栏，提取图片，并通过本地转换流程处理公式。如果文档看起来是扫描件，Oleafly 可以用工具所用模型转写其中的页面。

## 需要检查什么

PDF 描述的是标记在页面上的位置，所以阅读顺序必须靠推断。请检查多栏页面、脚注、表格、公式、图注、行尾的连字符断词和参考文献列表。提取图片成功时，图片文件会放在 `assets/` 下。

:::caution[扫描件需要视觉模型]
转写扫描版 PDF 需要能够读图的模型，最多接受 50 页。提取文字层不需要 AI。除非你为扫描件选择托管模型或 Mathpix，否则两种方式都不会上传 PDF。
:::

Markdown 无法重现每一个页面布局的决定。请把输出当作待编辑的内容，而不是原 PDF 的视觉副本。