dvanoni/notero · 上手攻略

  • 仓库:dvanoni/notero
  • 链接:https://github.com/dvanoni/notero
  • 分类:academic-writing
  • 作者:Tom
  • 更新:2026-08-20

这是什么

Notero 是一个 Zotero 插件,将 Zotero 中的文献条目(items)和笔记(notes)同步到 Notion 数据库。它解决的是"文献管理在 Zotero,写作与笔记在 Notion"割裂的问题——让两个工具无缝联动,不需要手动复制粘贴元数据。

解决什么问题

写学术论文时,很多人用 Zotero 管理 PDF 和引用,用 Notion 做阅读笔记和知识库。两者之间需要手动同步:标题、作者、期刊、DOI 等元数据要反复复制粘贴,工作繁琐且容易出错。

Notero 把这件事自动化:你只需在 Zotero 里操作,同步全部在后台完成,Notion 端自动生成文献页面,包含完整元数据,甚至支持 PDF 标注(高亮、笔记)的同步。

快速安装

前置要求

  • Zotero 7.0 或更高版本(注:最新 release 要求 Zotero 10+)
  • Notion 账号
  • Notero GitHub 官方下载页面:https://github.com/dvanoni/notero/releases/latest

安装步骤

第一步:下载 .xpi 文件

从 GitHub Releases 页面的 Assets 中下载最新 .xpi 文件(文件名类似 notero-x.x.x.xpi)。

Firefox 用户:右键下载链接 → "另存为"来下载文件。

第二步:安装到 Zotero

  1. Zotero → Tools → Plugins
  2. 将下载的 .xpi 文件拖入 Plugins 窗口;或点击齿轮菜单 → "Install Plugin From File..." → 选择文件
  3. 重启 Zotero

第三步:连接 Notion

⚠️ v1.0.0 后不再需要手动创建 Notion Internal Integration,改用官方 OAuth 认证流程,更简单。

  1. Zotero → Tools → Notero Preferences(或 Zotero 侧边栏的 Notero 面板)
  2. 点击 Connect to Notion 按钮
  3. 浏览器打开 Notion 授权页,选择目标 Workspace
  4. 选择:使用官方模板数据库,或连接已有 Notion 数据库
  5. 点击 Allow access → 自动跳转回 Zotero 完成授权

核心用法

手动同步单个条目

在 Zotero 主窗口选中条目 → 右键 → Sync to Notion

手动同步整个收藏夹

在侧边栏对收藏夹右键 → Sync Items to Notion

自动同步配置

在 Notero Preferences 中: - 勾选 Sync when items are modified:Zotero 条目修改后自动同步到 Notion(默认开启) - 勾选 Sync notes:笔记同步 - 在 Collections 中勾选需要监控的收藏夹

PDF 标注同步

  1. 在 Zotero 中打开 PDF,点选文字高亮或写笔记
  2. 右键 PDF 或条目 → Add Note from Annotations:将 PDF 标注转为 Zotero 笔记
  3. 该笔记会自动随条目同步到 Notion

右键菜单选项(摘要)

操作 路径
同步单个/多个条目 右键 → Sync to Notion
同步整个收藏夹 收藏夹右键 → Sync Items to Notion
PDF 标注转笔记 右键 PDF/条目 → Add Note from Annotations
Notero 设置 Tools → Notero Preferences

典型适用场景

  • 学术写作流程:Zotero 管 PDF 和引用,Notion 写阅读笔记和文献综述,两者自动同步
  • 研究生开题/综述:管理数百篇文献,每个条目在 Notion 有独立页面,可加标签、关联项目、链接到其他笔记
  • 课题组共享文献库:Notion 数据库可多人协作,Notero 确保所有成员添加的文献自动汇入共享知识库
  • 知识管理:Notion 的 Backlinks 让笔记之间互相连接,构建文献引用网络

坑与注意

  1. Zotero 版本要求严格:最新 Notero release 需要 Zotero 10+。仍在使用 Zotero 6/7/8/9 的用户须回退到 v1.2.3

  2. Notion 数据库字段要求:Notero 同步需要 Notion 数据库包含特定属性(Title、Authors、Publication Year 等)。使用官方模板最省事;连接受已有数据库时需确认字段匹配。

  3. 标签与附件延迟显示:Notero 添加 notero 标签和 Notion 链接附件时,不会主动通知 Zotero UI,切换条目再返回即可刷新。

  4. 大量条目同步速度:首次同步大量文献时,Notion API 有速率限制,可能需要分批手动触发。

  5. v1.0.0 认证方式变更:1.0.0 之前使用手动 Internal Integration Token;升级后需点击 "Upgrade Connection" 切换到新版 OAuth 认证,否则连接会失效。

  6. PDF 标注同步依赖手动转换:Notero 不会自动将 PDF 标注转为笔记,需要先手动执行 "Add Note from Annotations"。

与同类对比

工具 同步方向 自动程度 PDF 标注 平台
Notero Zotero → Notion 高(自动修改同步) 支持(需手动转换) Zotero 插件
Zotero Notion Import Zotero → Notion(一次性) 低(手动触发) 不支持 独立脚本
Notion for Scholars 手动复制 不支持 浏览器插件
Citation Manager + Notion 手动 不支持

Notero 是目前 Zotero → Notion 同步生态中自动化程度最高的方案,Stars 3198 的社区认可度也远超同类项目。

一句话推荐结论

如果你同时用 Zotero 和 Notion 做学术写作,Notero 是目前最值得安装的插件——把手动复制文献信息的繁琐彻底省掉,让两个工具真正联动起来。