要把 PDF 或 Word 文档作为真正的笔记放进 Obsidian,请将其转换为 Markdown,并把结果保存到库(vault)中的某个文件夹里。Obsidian 可以直接打开 PDF,但 PDF 始终只是附件:只能在查看器中阅读,库搜索也不会查找其中的内容。

Obsidian 把笔记以 Markdown 文件的形式保存在电脑上的一个普通文件夹中,这个文件夹称为库。转换后的文档只是该文件夹中多出的一个 Markdown 文件,因此 Obsidian 会像对待您亲手写的笔记一样对待它。

深色石质桌面上,一台屏幕模糊的笔记本电脑旁放着一本摊开的横线本、一支淡紫色铅笔和干薰衣草。
文档变成笔记,与您已有的笔记放在一起。

Obsidian 如何处理 PDF、Word 和 EPUB 文件

Obsidian 支持的文件格式列表 包括 Markdown、图片、音频、视频和 PDF,以及它自己的白板(canvas)和 Bases 文件。Word 文档和电子书不在其中。

文件Obsidian 的处理方式
PDF在内置查看器中打开。可以在打开的 PDF 中搜索,复制附带段落链接的引文,并将文件嵌入笔记。
DOCX无法打开。开启“Show all file types”设置后,该文件会显示在文件列表中,并且可以链接到它。
EPUB无法打开。与 DOCX 文件一样,只能显示在列表中并被链接。

最主要的区别在于搜索。Obsidian 的 搜索帮助页面 说明,搜索只查找笔记和白板的内容,因此 PDF 中的句子不会出现在库搜索结果中。PDF 查看器也不支持批注和高亮,参见 Obsidian 的 PDF 帮助.

文档变成 Markdown 笔记后,其文字会出现在搜索中,也可以像其他笔记一样编辑、链接到其中的标题并添加属性。

为什么 Importer 插件不支持这些文档

Importer 是 Obsidian 团队推出的官方插件,用于从其他应用迁移笔记。截至 2026 年 10 月,它支持从 Notion、Evernote、Apple Notes、Microsoft OneNote、Google Keep、Bear、Roam Research、Logseq 等少数几款应用导入,还支持 HTML、CSV、Markdown 和 Textbundle 文件。

Word、PDF 和 EPUB 不在 支持的格式列表中。对于这些文件,需要在交给 Obsidian 之前单独完成转换。

在库中的文件夹里转换文档

MD Factory 会把每个 Markdown 文件保存在原件旁边。最简单的布局是在库中为要变成笔记的文档建一个文件夹:

My vault/
  Imports/
    Annual report.pdf
    Annual report.md
    Annual report_images/
    Team handbook.docx
    Team handbook.md
    Team handbook_images/
  1. 在库中新建一个文件夹,例如 Imports,然后把文档复制进去。
  2. 打开 MD Factory,选择添加文件夹,或把文件夹拖到窗口上。转换会立即开始。
  3. 留意每个文件的状态:已完成、需要检查或失败。对于需要检查的文件,请打开其详细信息。
  4. 切换到 Obsidian。新笔记已经出现在文件列表中,因为 Obsidian 会自动识别从外部添加的文件。

只添加导入用的文件夹,不要添加整个库。MD Factory 会转换文件夹及其子文件夹中所有受支持的文件,因此添加整个库也会把作为附件保存的 PDF 转换成笔记。

如果希望把原件留在库外,就在原处转换,然后将每个 Markdown 文件连同其图片文件夹一起移入库中。如果 MD Factory 无法写入文档所在的文件夹,它会询问结果保存到哪里。

MD Factory 在您的电脑上完成转换,不会上传文档。每种格式都有各自需要检查的细节,以下指南分别做了介绍:

文档中的图片会以 PNG 文件保存在以笔记命名的文件夹中,例如 Team handbook_images。笔记用标准的 Markdown 图片链接和相对于笔记的路径引用这些图片:

![](Team%20handbook_images/image-5c2e9f0a4b7d13e86a21.png)

路径中的空格写作 %20。Obsidian 的帮助要求 Markdown 风格的链接使用这种编码,而且 Obsidian 既能读取自身的 Wiki 链接,也能读取 Markdown 链接。之后自己添加的链接可以继续使用 Wiki 链接格式。

打开一篇转换后的笔记,滚动到图片处,确认图片能正常显示。让每篇笔记和它的图片文件夹放在一起。如果在 Windows 文件资源管理器中只移动笔记,它的图片链接就会指向一个已不在旁边的文件夹。

转换后的书中的链接(如脚注引用)指向同一篇笔记中的位置。如果需要用到这些链接,请在 Obsidian 中点开几个,看看它们跳转到哪里。

保留原件,修改后重新转换

MD Factory 不会修改源文档,因此 PDF 或 DOCX 会留在笔记旁边。请保留它:表格、图表或扫描页对照原件更容易核对。要在笔记中显示原始 PDF,请带上页码将其嵌入,具体见 Obsidian 关于嵌入文件的帮助:

![[Annual report.pdf#page=3]]

文档有变化时,请再次将其添加到 MD Factory。如果该文档仍在上次运行留下的列表中,请先选择清除。如果之前的笔记没有改动,新结果会替换它。如果编辑过笔记,MD Factory 会保留您的版本,并用带编号的名称保存新结果,例如 Annual report (2).md。在 FAT32 或 exFAT 格式的驱动器上,新结果总是使用带编号的名称。

为了让重新转换更省事,请把自己的批注写在另一篇链接到转换笔记的笔记里。这样转换后的笔记始终是文档的干净副本,您的批注在下次转换后也会保留。

库中使用属性时自行添加

MD Factory 不会添加前置元数据(front matter)。如果您的库依赖 属性,请自行添加:在笔记第一行输入三个连字符,或运行“Add file property”命令(Ctrl+;)。

---
source: "[[Annual report.pdf]]"
tags:
  - imported
---

如示例所示,属性中的内部链接要放在引号里。添加属性也算编辑,因此该文档下次转换的结果会以带编号的名称保存。