hans/obsidian-citation-plugin · 上手攻略

  • 仓库：hans/obsidian-citation-plugin
  • 链接：https://github.com/hans/obsidian-citation-plugin
  • 分类：academic-writing / Obsidian 插件
  • 作者：Tom
  • 更新：2026-08-22

这是什么

obsidian-citation-plugin 是 Obsidian 的第三方插件，将学术文献管理器（核心支持 Zotero + Better BibTeX）与 Obsidian 编辑体验深度打通。它让你在 Obsidian 内直接搜索文献、自动创建和管理论文/书籍的「文献笔记」（Literature Notes），并以标准引用格式链接回来。

核心解决的痛点：学术写作者在 Obsidian 里做笔记时，文献元数据（作者、年份、DOI、摘要）和笔记本体互相割裂——这个插件把 Zotero 的文献库变成了 Obsidian 的可查询、可插入、可模板化的内置资源。

解决什么问题

  • 在 Obsidian 里搜索 Zotero 文献（按标题、作者、关键词）
  • 一键为某篇论文创建「文献笔记」文件（literature note）
  • 在任意笔记中插入 Pandoc 风格引用（@key / [@key]）
  • 文献笔记模板完全自定义，自动填入摘要、作者、年份等元数据
  • 支持 BibTeX/BibLaTeX .bib 和 CSL-JSON 两种格式

不适合的场景：纯非学术笔记、非 Zotero 用户（其他文献管理器支持尚在规划中）、需要 PDF 内文本搜索（那是 Zotero 的职责，不是这个插件的）。

快速安装

前提条件

  • Obsidian 0.9.20 及以上（2020 年底之后的版本均满足）
  • Zotero + Better BibTeX 插件（推荐 BibLaTeX 导出格式）
  • 一份已导出的文献库文件（.bib 或 .json）

步骤一：在 Obsidian 中启用第三方插件

Obsidian 设置 → 第三方插件 → 开启社区插件市场（若未开启）→ 搜索 citation → 安装 Obsidian Citation Plugin。

步骤二：配置文献库路径

  1. Zotero 端导出： - 在 Zotero 中选中一个 collection - File → Export Library... - 格式选 Better BibLaTeX（推荐，字段最全）或 Better CSL JSON（速度更快） - 勾选 Keep updated（自动重导出，保持同步）

  2. Obsidian 端配置： - Obsidian 设置 → Citations 标签页 - 在 Citation export path 文本框中粘贴导出的 .bib 或 .json 文件路径

  3. 关闭设置对话框，即可开始使用。

核心用法

搜索文献（Ctrl+Shift+O）

调用命令面板（Ctrl+P），输入 Open literature note，插件会弹出搜索框，输入论文标题、作者或关键词，找到后回车即可自动创建或打开该文献对应的笔记文件。

插入引用（Ctrl+Shift+E）

在任意笔记中，将光标放在需要引用的位置，按 Ctrl+Shift+E，搜索并选择文献，插件会在当前位置插入一个指向文献笔记的内部链接（形如 [[@citekey]]）。

插入 Pandoc 风格引用

如果你的笔记最终要通过 Pandoc 渲染（学术论文常用），可以在插件设置中绑定热键，插入形如 [@author2024] 的 Pandoc citation。插件支持自定义引用格式模板。

查看/更新文献笔记内容

Ctrl+Shift+C（无默认热键，需在设置中配置）可将文献的元数据字段以块形式插入当前光标位置，适合批量更新老笔记的元数据。

模板自定义

插件支持完全自定义文献笔记的文件名模板和内容模板，通过 Obsidian 设置 → Citations → Templates 配置。

可用变量：

变量 说明
{{citekey}} 引用键（如 jensen2024transformer）
{{title}} 论文标题
{{authorString}} 作者列表字符串
{{year}} 出版年份
{{abstract}} 摘要
{{DOI}} 数字对象标识符
{{URL}} 在线链接
{{publisher}} 出版社
{{containerTitle}} 期刊/会议名
{{eprint}} 预印本编号
{{zoteroSelectURI}} Zotero 直接打开链接

示例内容模板（YAML front matter + 摘要）：

---
title: {{title}}
authors: {{authorString}}
year: {{year}}
doi: {{DOI}}
---

## Abstract

{{abstract}}

## Notes

<!-- 在此处写阅读笔记 -->

## References

{{zoteroSelectURI}}

典型适用场景

  1. 学术写作者：用 Obsidian 做长篇文献综述，每个论点背后都自动挂靠 Zotero 文献笔记
  2. 博士/硕士论文：用双链笔记管理 100+ 篇论文的阅读笔记，支持随时回查原文
  3. 研究团队：团队成员共享 .bib 导出文件，各自的 Obsidian 文献库自动同步
  4. 跨工具研究者：同时用 Zotero 管理 PDF、Obsidian 写笔记，插件负责两者之间的桥梁

坑与注意

⚠️ Zotero 8 兼容性已知问题：2025 年中后期，有用户报告 Zotero 8 下 Better BibTeX 的 citekey 导出行为发生变化，导致插件无法正确生成笔记链接。解决方法：手动在 Zotero 中将 Accessed 日期修改为 2026 年 1 月之前的日期，或等待插件更新支持 Zotero 8 的新 API。（版本信息未经独立核验，建议在 Zotero 社区论坛确认当前状态）

⚠️ BibLaTeX vs CSL-JSON 性能差异：BibLaTeX 字段最全但加载慢（数千篇文献时可能卡顿数秒）；CSL-JSON 更快但字段较少。如果文献库超过 500 篇且感觉卡顿，切换到 CSL JSON 格式。

⚠️ 文献笔记 ≠ PDF 标注：这个插件只管理文献的元数据和笔记文件，不负责 PDF 全文内容提取。PDF 内的高亮标注仍需使用 Zotero 或专门的 PDF 标注插件。

⚠️ 模板变量大小写敏感：{{citekey}} 不能写成 {{CiteKey}}，Obsidian 模板引擎对此严格。

⚠️ 热键可能与其他插件冲突：Ctrl+Shift+O 等组合键若与其他 Obsidian 插件冲突，需在插件设置中重新分配。

与同类对比

插件 核心定位 Zotero 支持 模板灵活性 引用格式
obsidian-citation-plugin 元数据 + 文献笔记 ✅ Better BibTeX 原生 ✅ 变量丰富 Pandoc / BibTeX
obsidian-zotero-link 仅双向链接 ✅ ❌ 无模板 无
Zotero Integration 插入引用 + 笔记 ✅ 中等 多种 CSL 样式
mdless-zotero 命令行笔记生成 ✅ 有限 BibTeX

核心差异：obsidian-citation-plugin 是目前 Obsidian 生态中对「文献笔记」这一概念支持最完整的插件——不只是插入引用，而是帮你从零构建每篇论文的专属笔记文件，并维护元数据的自动填充。Zotero Integration 更偏向「在 Obsidian 里引用 Zotero 中的 PDF」，而这个插件更偏向「为每篇论文建立可扩展的阅读笔记」。

一句话推荐结论

如果你是学术写作者且使用 Zotero，强烈推荐安装——它是目前 Obsidian 学术界工作流中成本最低、收益最高的插件之一，将文献阅读和笔记写作真正融合在同一个工具里。