ARTICLE · 1159677
Zotero必装插件之Better Notes高效使用:7 招让批注自动长成综述初稿
上一篇《Zotero 必装插件 Top 10》发出去之后，有粉丝希望看到其中一个插件 Better Notes 的使用教程：
「装了。然后打开一看，跟原来的笔记框也没啥区别啊。」
小编得替它说句公道话：这话没说错，但只对了一半。
Better Notes 装好之后，如果你还是像以前一样——新建笔记、手动敲标题、手动敲作者、手动敲年份——那它确实只是个「稍微好看点的编辑器」。
它真正值钱的地方，是三件你还没用到的事：
- 把 PDF 里的划线和批注自动收进笔记（不用手抄）
- 把重复的排版动作交给模板（一次写好，之后永远一键）
- 把笔记搬出 Zotero（进 Word、进 Obsidian、进思维导图）
只当编辑器用，你大概只用了它 10% 的功能。
今天这篇就讲 7 招，从「能用」到「好用」。招招都是能立刻照着做的，不是概念。
开工前：先把版本对一下
动手之前，先确认你装的是对的：
- Better Notes 当前稳定版 v3.3.3，2026-08-24 发布
- 兼容 Zotero 8 / 9 / 10（你现在大概率是 Zotero 10.0.5，2026-10-01 发的，没问题）
- 免费、开源，AGPL-3.0，GitHub 上 8.3k star，作者是 windingwind
- 装法：工具 → 插件 → 右上角齿轮 → Install Plugin From File → 选
.xpi → 重启
顺带说一句，Better Notes 是少数几个在 Zotero 10 发布后几天内就跟上兼容的插件，维护很勤快。这也是小编一直愿意推它的原因——插件这东西，作者还在不在，比功能多不多重要得多。
第 1 招：批注一键变笔记，格式你说了算
先解决最痛的一件事：读完就忘。
你在 PDF 里划了 20 条线、写了 8 条批注，合上 PDF 之后这些就沉在附件里了，写综述的时候根本想不起来。
Zotero 自带一个「从批注添加笔记」，但格式是写死的——一堆带页码的引用堆在一起，看着很乱，还得自己重新排版。
Better Notes 的做法不一样：它把这件事也做成了一个模板，而模板是你能改的。
操作：
在 PDF 阅读器里选中你要收进去的批注（可以多选） 右键 → 转成笔记（BN 会把批注渲染成笔记内容） - 生成的格式由内置模板
[QuickNote] 控制 - 想改格式？ 进模板编辑器，找到
[QuickNote] 系列模板，直接改
这就是为什么小编说它「格式你说了算」——你可以让批注按「页码 - 原文 - 我的想法」三栏排，也可以让它只保留高亮原文不保留页码，全看你那一行模板怎么写。
给个实操建议：把 [QuickNote] 模板改成「高亮原文 + 我的评论」两行一组，去掉冗余的页码时间戳。这样导出来的笔记直接就能往综述里塞。
第 2 招：一条模板，让所有文献笔记长一个样
这一招是省时间的大头。
回想一下你现在怎么做文献笔记：新建笔记 → 敲标题 → 敲作者 → 敲年份 → 敲期刊 → 敲 DOI → 建「研究问题」「方法」「结论」「我的评价」几个小标题。
一篇 3 分钟，一个学期 60 篇，就是 3 个小时——全是纯体力活。
Better Notes 的模板能把这些全自动化。 原理很简单：模板里可以写 JavaScript，直接读 Zotero 里已有的元数据。
一个最小可用的文献精读模板，长这样（照着敲就行）：
- 第 1 行写
// @use-markdown（声明用 Markdown 渲染，不写就按 HTML 处理） - 第 2 行写
# ${topItem.getField("title")}（自动填标题） - 第 3 行写
**作者**：${topItem.getCreators().map(au => au.lastName + " " + au.firstName).join("; ")} - 第 4 行写
**年份**：${topItem.getField("year")} - 第 5 行写
**期刊**：${topItem.getField("publicationTitle")} - 第 6 行写
**DOI**：${topItem.getField("DOI")} - 然后是你自己要填的四个小标题：
## 一句话结论、## 方法与数据、## 我的质疑、## 能用到我哪篇论文里
把这段存成模板之后，每篇文献点一下，前面 6 行自动填好，你只需要填后面 4 个空。
模板怎么建：
- Zotero 菜单 → 工具 → Note Template Editor（笔记模板编辑器）
- 新建模板，名字必须以
[Item] 或[Text] 开头（比如[Item] 文献精读笔记） 粘贴内容 → 保存 - 用的时候：打开笔记 → 编辑器工具栏点 Insert Template to cursor line → 选你的模板
懒人捷径：不想自己写？官方社区有个模板库，几百个现成的模板（GitHub 仓库 Discussions 的 note-templates 分类）。挑一个顺眼的，复制代码 → Zotero 菜单 → 工具 → New Template from Clipboard（从剪贴板新建模板）→ 一键导入。
小编的建议是：先用别人的，用到不顺手再改。 别一上来就从零写，那是本末倒置。
第 3 招：@use-refresh —— 笔记不是一次性产物
这一招知道的人不多，但很救命。
场景：你三个月前用模板给 20 篇文献生成了笔记，现在要给它们统一加一个「分区」字段，或者标题改了、标签加了。
正常情况下你只能删了重做。
加了 // @use-refresh 这个声明的模板，生成的内容是可以「刷新」的。
操作：在模板第一行加上 // @use-refresh，之后在笔记编辑器里点 Update content from templates，它会重新跑一遍模板，把模板负责的那部分内容更新掉，而你手写的部分不动。
意思是：模板生成的归模板，你写的归你，互不干扰。
⚠️ 一个坑：用了 @use-refresh 的模板，内容里不能出现分隔线（--- 或 <hr>）。因为刷新功能靠分隔线和 YAML 标记来识别「哪一段是模板生成的」，你这内容里再插一条分隔线，它就认不出来了。
第 4 招：三阶段模板，把 20 篇文献压成一张对比表
这一招是整篇里最值钱的，也是 90% 的人不知道的。
第 2 招的模板只处理「一篇文献」。但写综述的时候，你要的是「二十篇文献横向对比」。
Better Notes 的 [Item] 模板支持三个阶段，这是它能做聚合的关键：
- beforeloop：循环开始前跑一次 —— 在这里写表头
- default：每篇文献跑一次 —— 在这里写表格的一行
- afterloop：循环结束后跑一次 —— 在这里写总结
用 // @beforeloop-begin / // @beforeloop-end 这类标记把三段包起来就行。
效果是这样的：你框选 20 篇文献 → 点一下模板 → 自动生成一张 20 行的对比表，每行是「标题 / 年份 / 方法 / 结论 / 我的评价」，你只需要在「我的评价」那一列填空。
写文献综述那张经典的「研究现状对比表」，原来要一天，现在十分钟出骨架。
给个思路：beforeloop 里写表头，default 里用 ${topItem.getField("title")} 和 ${topItem.getField("year")} 取标题年份，afterloop 里你可以统计篇数、列出所有标签。
⚠️ 但是有个硬限制，见后面「避坑」第 1 条。这个坑会让你同步失败。
第 5 招：双链 + 关系图谱，让笔记自己长成网
单篇笔记记再多，也还是孤岛。
Better Notes 支持笔记之间的双向链接，在编辑器标题栏点链接按钮就能建。两个方向要分清：
- Link to：把「别的笔记」的链接插进当前笔记（出站链接）
- Mention in：把「当前笔记」的链接插进别的笔记（入站链接）
建完之后：
- 鼠标悬停 + Ctrl/Cmd 可以预览被链接的笔记，不用跳走
- 右侧上下文面板里有关系图谱，能看到笔记之间的连接
- v3.3 之后还加了整个文献库的笔记图谱（不只是单篇的关系）
怎么用才不白建？ 小编的习惯是：每读完一篇，就问自己一句「这篇跟前面哪篇是对着干的、或者接着干的」，然后建一条链接。积累到三四十篇，图谱上会自动浮现出几个聚类的团——那就是你综述的章节划分。
第 6 招：导出与双向同步 —— 笔记别锁死在 Zotero
笔记写在 Zotero 里，最大的隐患是「出不去」。
Better Notes 的导出在编辑器工具栏，四种格式：
- Markdown（图片可选内嵌或链接式）—— 给 Obsidian / Typora / 任何 Markdown 编辑器
- Word（.docx）—— 直接进论文
- PDF—— 存档、给导师看
- FreeMind（.mm）—— 思维导图格式，可以导入 XMind 之类的软件拉成脑图
真正让小编离不开的是双向同步：
- 第一次导出时，勾选 Set Auto-Sync，指定一个文件夹（比如你的 Obsidian 库）
- 之后你在 Zotero 里改笔记，或者在 Obsidian 里改那个 .md 文件，两边会自动互相同步
不用装任何第三方同步工具，不用写脚本。
⚠️ 两个要注意的点：
- 同步不是实时的。它发生在「编辑器关闭之后」，并且还要过你在偏好设置里设的自动同步周期。改完别急着关软件去另一个软件里找。
- 开自动同步之前，先手动导出一次看看效果。确认格式、图片路径、YAML 头都对得上，再开自动。不然双向同步会把两边的乱七八糟一起放大。
第 7 招：Magic Key + 多标签页，手不离键盘
最后两招是纯提速的，五分钟就能上手。
Magic Key（命令面板）：在笔记编辑器里按 /，或者 Ctrl + /（Mac 是 Cmd + /），弹出一个命令面板。插模板、改格式、执行常用操作，全在这里面，动键盘不用动鼠标。
多标签页 / 独立窗口：
- 在文献列表里双击笔记 → 在标签页中打开（跟打开 PDF 一样）
- 按住 Shift 双击 → 弹出独立窗口
- 想开多少开多少，不再受 Zotero 原生那个单笔记面板的限制
写综述的时候，左边开着对比表，右边开着某篇的精读笔记，中间是正在写的综述正文——三个窗口同时摆着，来回切的成本归零。
三个坑，踩一个就白干
坑 1：笔记有 20 万字符上限，超了同步不了
这个是 Zotero 官方明确过的：单条笔记上限 20 万字符（注意是字符数，标注、格式、引用信息全都算进去）。
第 4 招那个「20 篇压成一张表」的用法，最容易撞这条线。 批注一多、引用信息一全，几万字就能顶到 20 万。
撞上的表现：笔记右上角出现红色感叹号，提示 "The note is too long to sync"。
怎么绕：
- 别把整个文献库塞进一条笔记，按主题分多条，用第 5 招的链接把它们连起来
聚合模板里去掉引用/标注的冗余信息 - 或者干脆用 File → Export Template to File 直接导出成文件，不生成笔记
官方的原话建议也是「按主题建笔记 + 用链接连接」，而不是堆成一条巨型笔记。
坑 2：模板预览模式下改不了文献库
在模板编辑器里点「预览」时，环境变量 _env.dryRun 是 true，这个模式下不能修改你的文献库。
所以有些模板「预览报错、实际能用」，不是模板坏了，是预览的限制。真要验证，就退出预览实跑一次。
坑 3：Zotero 升级后先确认插件跟上
老规矩：先升插件，再升 Zotero。Better Notes 在 Zotero 10 上要从 3.3.x 起才稳，如果你还停在 3.2.x 又升了 Zotero 10，出问题先升插件。
一条流水线，把 7 招串起来
单独看，7 招是 7 个技巧；串起来，它是一条完整的文献处理流水线：
- 读 PDF：划线、写批注
- 第 1 招：批注一键转成笔记，格式是你要的
- 第 2 招：套模板，元数据自动填好，你只填思考部分
- 第 5 招：跟相关的笔记建链接
- 第 4 招：攒够一批，用三阶段模板压成对比表
- 第 6 招：导出 Word，综述初稿的骨架就有了
- 第 3 招：后面文献信息有变动，刷新一下就行
你会发现，真正需要你亲手写的东西变少了——剩下的全是判断和思考，也就是科研里真正值钱的那部分。
这才是「提升科研效率」的正确打开方式：不是写得更快，是把重复的部分删掉。
从哪一步开始？
如果看完还是不知道从哪下手，小编的建议是这个顺序：
第一周：先只用第 1 招（批注转笔记）+ 从社区模板库导入一个现成模板。别的都别碰。
第二周：把那个模板改成自己的样子，加上 @use-refresh。
第三周：试第 4 招的三阶段模板，拿 5 篇文献练手。
之后：再考虑双向同步和图谱。
别一上来七招全开。工具这东西，用得上的那一招，比全部七招都值钱。