要把 PDF 或 Word 文档作为真正的笔记放进 Obsidian,请将其转换为 Markdown,并把结果保存到库(vault)中的某个文件夹里。Obsidian 可以直接打开 PDF,但 PDF 始终只是附件:只能在查看器中阅读,库搜索也不会查找其中的内容。
Obsidian 把笔记以 Markdown 文件的形式保存在电脑上的一个普通文件夹中,这个文件夹称为库。转换后的文档只是该文件夹中多出的一个 Markdown 文件,因此 Obsidian 会像对待您亲手写的笔记一样对待它。
Obsidian 如何处理 PDF、Word 和 EPUB 文件
Obsidian 支持的文件格式列表 包括 Markdown、图片、音频、视频和 PDF,以及它自己的白板(canvas)和 Bases 文件。Word 文档和电子书不在其中。
| 文件 | Obsidian 的处理方式 |
|---|---|
| 在内置查看器中打开。可以在打开的 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/
- 在库中新建一个文件夹,例如
Imports,然后把文档复制进去。 - 打开 MD Factory,选择添加文件夹,或把文件夹拖到窗口上。转换会立即开始。
- 留意每个文件的状态:已完成、需要检查或失败。对于需要检查的文件,请打开其详细信息。
- 切换到 Obsidian。新笔记已经出现在文件列表中,因为 Obsidian 会自动识别从外部添加的文件。
只添加导入用的文件夹,不要添加整个库。MD Factory 会转换文件夹及其子文件夹中所有受支持的文件,因此添加整个库也会把作为附件保存的 PDF 转换成笔记。
如果希望把原件留在库外,就在原处转换,然后将每个 Markdown 文件连同其图片文件夹一起移入库中。如果 MD Factory 无法写入文档所在的文件夹,它会询问结果保存到哪里。
MD Factory 在您的电脑上完成转换,不会上传文档。每种格式都有各自需要检查的细节,以下指南分别做了介绍:
笔记中的图片和链接如何工作
文档中的图片会以 PNG 文件保存在以笔记命名的文件夹中,例如 Team handbook_images。笔记用标准的 Markdown 图片链接和相对于笔记的路径引用这些图片:

路径中的空格写作 %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
---
如示例所示,属性中的内部链接要放在引号里。添加属性也算编辑,因此该文档下次转换的结果会以带编号的名称保存。