导入 PDF：拖拽上传或 /upload 命令

先说明一个边界

PDF 批注功能目前只在桌面端（Windows / macOS / Linux）完整支持。移动端可以看到 PDF 文件但不能批注。

三种导入方式

方式一：直接拖拽（最简单）

在任意页面新建一个空白块，然后把 PDF 文件从文件管理器拖到那个块上——Logseq 会自动：

1. 把 PDF 复制到图谱的 assets/ 文件夹
2. 在块位置创建一个 PDF 链接
3. 自动打开 PDF 阅读器

方式二：/upload asset 命令

在任意块里输入 /upload asset，选择 PDF 文件即可。效果和拖拽一样。

方式三：绝对路径链接

如果你不想把 PDF 复制到 assets 文件夹（比如 PDF 在别的位置、空间不够），可以在块里写外部绝对路径：

- 这篇论文很重要：[[/Users/you/Documents/papers/transformer.pdf]]

这种方式不会复制文件，直接读取原位置。注意路径里的斜杠方向和空格。

assets 文件夹

所有导入到图谱的文件（PDF、图片、视频等）统一存在图谱目录下的 assets/ 文件夹里。每个文件会生成一个带 hash 的唯一文件名，防止重名覆盖。

目前 Logseq 没有自动清理 assets 的功能——即使你删除了引用它的块，文件仍然会留在 assets 里。需要释放空间时手动清理：确认没有任何块引用某个文件后，再删除它。

Zotero 集成

Logseq 可以和 Zotero 文献管理器联动。设置好 Zotero 的数据源后，在 Logseq 里可以：

• 直接从 Zotero 导入文献元数据
• 把 PDF 从 Zotero 库链接到 Logseq 页面
• 在 Logseq 里写阅读笔记时自动带上 Zotero 的 Citekey

设置方法：Settings → Features → Zotero Integration，填入 Zotero 的数据目录路径。

嵌入 vs 独立阅读器

导入 PDF 后有两种使用方式：

• 独立阅读器：点击 PDF 链接 → 打开专门的阅读器面板（有完整的批注工具栏）
• 嵌入页面：用特定语法把 PDF 嵌入到任意页面中间（适合在笔记里直接看到 PDF 内容）

批注只在独立阅读器里可用。