Obsidian 学习笔记

Appearance

Zotero 集成 ​

Zotero 是最流行的开源文献管理工具，与 Obsidian 配合使用可以打造完整的学术研究工作流。本指南将详细介绍两者的集成方法。

为什么使用 Zotero + Obsidian ​

Zotero 的优势 ​

  • 自动获取元数据：一键导入论文信息
  • PDF 管理：自动下载和组织 PDF
  • 引用生成：支持数千种引用格式
  • 云端同步：跨设备同步文献库
  • 浏览器插件：一键保存网页内容

集成的好处 ​

Zotero 负责Obsidian 负责
文献收集阅读笔记
元数据管理知识整理
引用生成思维链接
PDF 存储内容标注

安装配置 ​

需要安装的组件 ​

  1. Zotero：文献管理软件
  2. Zotero Connector：浏览器插件
  3. Better BibTeX：Zotero 插件
  4. Obsidian 插件：Zotero Integration 或 Citations

安装 Zotero ​

下载地址：

安装步骤：

  1. 下载对应系统版本
  2. 运行安装程序
  3. 首次启动创建账户
  4. 配置同步选项

安装 Better BibTeX ​

步骤：

  1. 打开 Zotero → 工具 → 插件
  2. 点击齿轮 → Install Add-on From File
  3. 下载 Better BibTeX
  4. 选择 .xpi 文件安装

配置引用键：

yaml
# 设置 → Better BibTeX → 引用键
格式: [auth][year]
示例: smith2020

# 推荐格式
author + year + shorttitle-firstword
结果: smith2020deep

安装 Obsidian 插件 ​

选择一：Zotero Integration

功能更强大，推荐使用：

  1. 设置 → 第三方插件 → 浏览
  2. 搜索「Zotero Integration」
  3. 安装并启用

选择二：Citations

轻量级选择：

  1. 搜索「Citations」
  2. 安装并启用

Zotero Integration 插件配置 ​

基本设置 ​

yaml
# 连接设置
Zotero 数据目录: ~/Zotero/ (自动检测)
通信端口: 23119 (默认)

# 导入设置
默认导入格式: Better BibTeX JSON
自动更新: true

配置模板 ​

创建文献笔记模板：

markdown
---
type: literature
citekey: {{citekey}}
authors: {{authors}}
year: {{year}}
title: {{title}}
journal: {{publicationTitle}}
volume: {{volume}}
issue: {{issue}}
pages: {{pages}}
doi: {{doi}}
url: {{url}}
tags: [文献, {{keywords}}]
date_added: {{dateAdded}}
---

# {{title}}

## 基本信息

| 属性 | 值 |
|------|-----|
| 作者 | {{authors}} |
| 年份 | {{year}} |
| 期刊 | {{publicationTitle}} |
| DOI | {{doi}} |
| Zotero | [打开]({{zoteroSelectLink}}) |
| PDF | {{pdfAttachment}} |

## 摘要

{{abstractNote}}

## 核心观点

### 观点 1

### 观点 2

## 方法论

## 结论

## 我的思考

## 重要引用

## 相关文献

- [[相关文献1]]
- [[相关文献2]]

## 笔记引用

```bibtex
{{bibtex}}

### 配置导入格式

在插件设置中配置：

```yaml
# 导入模板
Import Formats:
  - 名称: 学术论文
    模板: 文献笔记模板
    保存路径: 文献库/论文
    
  - 名称: 书籍
    模板: 书籍笔记模板
    保存路径: 文献库/书籍

使用流程 ​

收集文献 ​

通过浏览器：

  1. 打开论文网页（如 Google Scholar）
  2. 点击 Zotero Connector 图标
  3. 自动保存元数据和 PDF

通过 DOI：

  1. Zotero → 添加条目（魔法棒图标）
  2. 输入 DOI 号
  3. 自动获取信息

通过 PDF：

  1. 将 PDF 拖入 Zotero
  2. 右键 → 检索元数据
  3. 自动补全信息

在 Obsidian 中导入 ​

方法一：命令面板

  1. Ctrl+P 打开命令面板
  2. 输入「Zotero Integration: Create Note」
  3. 搜索并选择文献
  4. 自动创建笔记

方法二：从 Zotero 拖拽

  1. 在 Zotero 中选中文献
  2. 拖拽到 Obsidian 编辑器
  3. 选择插入格式

链接 PDF ​

自动链接：

配置插件自动将 PDF 链接到笔记：

yaml
PDF 处理:
  复制到库: true
  目标文件夹: 附件/PDF
  重命名规则: {year}_{author}_{title}

手动链接：

markdown
## PDF 文件

![[{{pdfPath}}]]

高级功能 ​

批量导入 ​

导入整个集合：

  1. 在 Zotero 中创建集合（文件夹）
  2. 打开 Obsidian 命令面板
  3. 选择「Zotero Integration: Import Collection」
  4. 选择集合并执行

脚本批量导入：

javascript
<%*
// 导入最近添加的文献
const zotero = app.plugins.plugins['obsidian-zotero-integration'];
const items = await zotero.getZoteroItems({
  sort: 'dateAdded',
  direction: 'desc',
  limit: 10
});

for (const item of items) {
  await zotero.createNote(item);
}
%>

导出标注 ​

从 PDF 导出高亮：

  1. 在 Zotero 中打开 PDF
  2. 添加高亮和注释
  3. 在 Obsidian 中使用插件导出

模板格式：

markdown
## PDF 标注

{{annotations}}

<!-- 或自定义格式 -->
{{#annotations}}
> [!quote] {{color}} 高亮
> {{text}}
> 
> **注释**: {{comment}}
> — {{page}}页

{{/annotations}}

引用管理 ​

在笔记中引用：

markdown
根据 [[@smith2020]] 的研究...

Smith 指出... [@smith2020, p. 15]

多项研究证实 [[@smith2020]] [[@jones2021]]...

生成参考文献列表：

使用 Citations 插件：

markdown
## 参考文献

```citations
@include[@*]

### 与 Dataview 联动

**查询文献笔记：**

```dataview
TABLE 
  authors as "作者",
  year as "年份",
  journal as "期刊"
FROM "文献库"
WHERE type = "literature"
SORT year DESC

统计阅读量：

dataviewjs
const papers = dv.pages('"文献库"')
  .where(p => p.type === "literature");

const byYear = papers.groupBy(p => p.year);

dv.table(
  ["年份", "数量"],
  byYear.rows.map(g => [g.key, g.values.length])
);

工作流示例 ​

学术研究工作流 ​

📥 收集 → 📖 阅读 → 📝 笔记 → 🔗 整合 → ✍️ 写作

详细流程：

  1. 收集阶段

    • 浏览器一键保存论文
    • 自动下载 PDF
    • 组织到项目文件夹

  2. 阅读阶段

    • Zotero 打开 PDF
    • 高亮重要内容
    • 添加批注

  3. 笔记阶段

    • 导入到 Obsidian
    • 提取核心观点
    • 链接相关笔记

  4. 整合阶段

    • 建立文献关联
    • 构建知识网络
    • 发现研究缺口

  5. 写作阶段

    • 引用文献
    • 生成参考文献
    • 导出提交

文献综述工作流 ​

步骤：

  1. 在 Zotero 创建专题集合
  2. 批量导入到 Obsidian
  3. 使用 Dataview 创建索引
  4. 提取各文献核心观点
  5. 创建综述笔记整合

综述模板：

markdown
---
type: literature-review
topic: {{主题}}
date: {{date}}
---

# 文献综述：{{主题}}

## 研究背景

## 主要观点

### 观点 1
- [[@文献1]] 认为...
- [[@文献2]] 支持...
- [[@文献3]] 持不同观点...

### 观点 2
...

## 研究方法

## 研究缺口

## 我的见解

## 参考文献

同步与备份 ​

Zotero 同步 ​

官方同步：

  • 免费 300MB 空间
  • 付费扩容

WebDAV 同步：

yaml
设置:
  同步 → 文件同步
  使用 WebDAV
  服务器: 你的WebDAV服务

推荐 WebDAV 服务：

  • 坚果云（国内）
  • TeraCloud（国外）
  • Nextcloud（自建）

Obsidian 同步 ​

确保文献笔记库在同步范围内：

yaml
Obsidian 同步:
  - 官方同步服务
  - iCloud (iOS)
  - Git 版本控制
  - Syncthing (P2P)

故障排除 ​

插件无法连接 Zotero ​

解决方案：

  1. 确保 Zotero 正在运行
  2. 检查端口 23119 是否开放
  3. 重启 Zotero
  4. 重新安装插件

引用键冲突 ​

解决方案：

  1. Better BibTeX 设置中启用自动去重
  2. 手动修改冲突的引用键
  3. 刷新 BibTeX 键

PDF 无法打开 ​

解决方案：

  1. 检查 PDF 路径是否正确
  2. 重新链接 PDF 文件
  3. 检查文件权限

元数据不完整 ​

解决方案：

  1. 右键 → 检索元数据
  2. 手动补充信息
  3. 使用 DOI 查询

最佳实践 ​

文献组织 ​

yaml
Zotero 文件夹结构:
  文献库/
  ├── 进行中的项目/
  │   ├── 论文1/
  │   └── 论文2/
  ├── 已完成的项目/
  ├── 待阅读/
  └── 参考资料/

笔记组织 ​

yaml
Obsidian 文件夹结构:
  文献库/
  ├── 论文/
  │   ├── @citekey1.md
  │   └── @citekey2.md
  ├── 书籍/
  ├── 会议/
  └── 文献索引.md

命名规范 ​

yaml
Zotero:
  引用键: author_year_shorttitle
  示例: smith2020_deep_learning

Obsidian:
  笔记名: @citekey
  示例: @smith2020_deep_learning.md

提示

Zotero + Obsidian 的组合是学术研究的利器。Zotero 负责文献收集和管理，Obsidian 负责阅读笔记和知识整理，各司其职，效率倍增。

INFO

建议定期备份 Zotero 数据目录（~/Zotero/），同时使用版本控制管理 Obsidian 笔记库。

注意

使用 WebDAV 同步 Zotero 附件时，确保服务器稳定可靠，避免数据丢失。

最后更新：2026年2月22日编辑此页反馈问题