三步从零搭建 Zotero Better Notes 智能笔记模板让文献笔记实现一键自动生成【免费下载链接】zotero-better-notesEverything about note management. All in Zotero.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-better-notes凌晨一点你对着第三篇论文复制标题、粘贴作者、手动对齐引用格式眼睛快睁不开了——这种机械重复的夜晚经历过一次就再也不想有第二次。Zotero Better Notes 的笔记模板功能正是为消灭这类重复劳动而生的你只需要写一份模板之后每打开一篇文献笔记都能按你的框架一键自动成型。这篇文章会带你从零动手先认识模板的构成再做出第一个最小可用的模板然后一步步给它加装脚本大脑、升级成文献专用模板、打通批量处理流程。全程不绕弯子每个阶段都有能直接抄走的代码。动手之前先认识模板这块积木的两个零件在写第一行模板代码前你只需要记住一件事任何一个笔记模板都由名称和内容两部分拼成就像一块积木的两个卡扣。名称必须以[类型]开头例如[Text] 随手记、[Item] 论文精读卡。方括号里的类型决定了模板能被用在什么场景后面会细讲。内容主体是 Markdown 或 HTML 排版文本中间可以混入 JavaScript 脚本来动态生成数据。模板本身是一段 YAML 文本既可以在编辑器里手动写也可以整段分享给别人。如果你之后想深入研究模板引擎的实现可以翻翻src/modules/template/目录下的api.ts和controller.ts类型定义在 typings/template.d.ts完整机制说明在 docs/about-note-template.md。第一块积木5 分钟做出你的第一个当前时间模板先别急着写复杂的文献模板我们从最小可用的例子开始。把下面这段代码完整复制name: [Text] 随手记 content: |- // use-markdown # 随手记 创建于${new Date().toLocaleString()}然后按这两步把它装进 Zotero点击 Zotero 菜单栏的「工具」选择「从剪贴板新建模板」粘贴后确认。打开任意一篇笔记在编辑器工具栏找到Insert Template to cursor line插入模板到光标所在行按钮从弹出的列表里选中「随手记」。你会看到笔记里立刻出现了标题和一行当前时间。别小看这行时间——它其实已经用上了模板的动态脚本能力${...}里的内容会被当作 JavaScript 执行执行结果替换回文本里。${{...}}$ 是它的多行版本里面可以写完整的函数逻辑。也就是说你在模板里写的不是死文字而是一段每次插入都会重新计算的活代码。 小提醒如果你在「笔记模板编辑器」里预览脚本返回时_env.dryRun会被置为true此时脚本里不要做任何改动库内容的操作防止误伤你的文献数据。第二块积木给模板装上会算数的脑袋${new Date()}只是开胃菜。真正让模板值钱的是它能读取文献条目字段。继续在「随手记」模板上加代码${{ const tagList topItem.getTags().map(t t.tag); return tagList.length ? 标签 tagList.join(、) : 这篇文献还没有标签; }}$这里出现了一个新变量topItem它代表正在被处理的当前文献条目。类似的常用字段读取有${topItem.getField(title)}—— 标题${topItem.getField(year)}—— 年份${topItem.getField(DOI)}—— DOI 编号${topItem.getCreators().map(au au.lastName).join(; )}—— 作者姓氏列表还可以给脚本套一层try/catch做容错避免遇到缺字段的文献时整段渲染报错${{ try { const t topItem.getField(title); return t || 这篇文献没有标题; } catch (e) { return 读取标题时出错; } }}$这样一来即使遇到信息残缺的条目模板也能优雅地给出兜底文案而不是让笔记生成失败。第三块积木把模板升级成论文精读卡现在我们把前面学的东西串起来做一个真正能用的文献专用模板。它的类型要改成[Item]——这种模板会针对文献条目循环处理是写文献笔记的主力。name: [Item] 论文精读卡 content: |- // use-markdown // use-refresh // author 你的昵称 # ${topItem.getField(title) || 未命名文献} ## 1. 这篇论文讲了什么 一句话概括 ## 2. 出处速览 | 项目 | 信息 | | --- | --- | | 作者 | ${topItem.getCreators().map(au [au.firstName, au.lastName].filter(Boolean).join( )).join(; ) || 佚名} | | 年份 | ${topItem.getField(year) || 不详} | | 期刊/会议 | ${topItem.getField(publicationTitle) || topItem.getField(conferenceName) || 未收录} | | DOI | ${topItem.getField(DOI) ? [${topItem.getField(DOI)}](https://doi.org/${topItem.getField(DOI)}) : 无} | ## 3. 核心结论 - - ## 4. 值得质疑与跟进的点 - [ ] - [ ]创建好之后选中一篇文献用同一枚插入模板按钮把它插入——你会看到标题、作者、年份、期刊、DOI 全部自动填好连 DOI 都直接变成了可点击的链接剩下的只是你动脑写结论。整个流程从手动复制粘贴的十几分钟压缩到了几秒钟。这个模板开头的// use-refresh也很关键它允许你之后用「从模板更新内容」重新刷新生成的部分。比如你修改了文献元数据一键更新就能把旧信息全部对齐不用再删了重做。让模板更进一步三阶段流水线与数据共享如果只是单篇生成[Item]模板已经够用。但当你同时选中十篇文献、想要一份统一格式的批量笔记时就该认识模板的三阶段结构了。用// 阶段名-begin和// 阶段名-end把内容圈起来就能让不同段落分别在不同时机执行阶段执行时机典型用途beforeloop循环开始前只跑一次写总标题、初始化统计变量default对每篇文献各跑一次生成每篇的核心内容afterloop循环结束后只跑一次写总结、汇总统计结果下面这段演示了三个阶段配合sharedObj共享数据完成标签统计// beforeloop-begin ${{ sharedObj.tags new Set(); return 开始批量生成文献笔记; }}$ // beforeloop-end // default-begin ## ${topItem.getField(title) || 未命名文献} ${{ topItem.getTags().forEach(t sharedObj.tags.add(t.tag)); return ; }}$ // default-end // afterloop-begin ${{ return 本次共涉及标签 [...sharedObj.tags].join(、); }}$ // afterloop-endsharedObj是贯穿三个阶段的公共储物柜beforeloop 阶段算好的东西后面的阶段都能取用。这样你就不用在每篇文献上重复计算相同的数据批量处理的性能也更好。背后的机关那些以 // 开头的特殊指令你在模板里会看到很多以// 开头的注释行它们不是普通注释而是控制模板行为的开关渲染时会被悄悄吃掉、不显示在笔记里。常见的有这些指令作用注意点// use-markdown声明按 Markdown 语法渲染不写的话模板会被当 HTML 处理// use-refresh允许生成结果被从模板更新刷新启用后正文里不能再出现---分隔线否则会干扰更新标记// author 你的名字标注模板作者分享模板时的署名// link 来源地址标注模板发布来源方便别人反馈问题// beforeloop-begin/end圈定某阶段的代码范围只有 Item 模板支持多阶段有个细节值得注意特殊指令必须单独成行不能藏在代码块里否则系统只会把它当作普通注释你的开关就失效了。三种模板类型怎么选别再纠结了打开模板编辑器你会发现模板类型远不止上面两种。快速对照这张表就能选对类型适用场景主要全局变量[Item]针对一篇或多篇文献条目批量生成topItem、items、sharedObj、targetNoteItem[Text]不绑定文献的通用文本如读书笔记、会议记录targetNoteItem、sharedObj内置模板系统功能如QuickInsert笔记链接、QuickNote注释转笔记、ExportMDFileName导出文件名link、noteItem、annotationItem 等内置模板的名字是系统锁定的不能改名。当项目有破坏性更新时旧模板会被保留并升级为V2、V3这样的新版本保证你已有的笔记不受影响。避坑日记新手最容易踩的 4 个坑我自己刚接触模板时以下四个坑基本都踩过一遍写出来帮你省掉这些冤枉路症状真实原因解决办法导入后模板列表里找不到YAML 格式不对name或content字段不完整检查缩进和字段名重新复制导入脚本原样输出、完全不执行JavaScript 语法错误打开 Zotero 调试控制台看报错定位到具体行点「从模板更新」后内容纹丝不动模板开头漏了// use-refresh补上这个指令再重新生成一次特殊符号显示成乱码在 Markdown 语法里出现了冲突字符改用 HTML 实体或转义字符另外提醒一句// use-refresh和正文分隔线是水火不容的如果你既想支持刷新又想在模板里画一条---分割线二选一吧别硬凑。把你的模板分享出去也去社区进货写好一份顺手的模板后分享给别人其实非常轻松打开「笔记模板编辑器」选中要分享的模板点击「选项」→「复制分享代码」系统会把它打包成标准的 YAML 分享格式name: [Item] 论文精读卡 content: |- // author 你的昵称 // link 发布页地址 模板正文……拿到别人分享的代码后用回文章开头那招——「工具」→「从剪贴板新建模板」——一键导入就能用。社区里已经积累了大量现成模板与其从零憋一份不如先进货再改造效率翻倍。现在就从这三个动作开始到这里模板的完整链路你已经摸清了。别急着追求一步到位按下面的顺序动手导入一个「当前时间」模板跑通导入和插入的完整流程找到手感改造一份现成模板把topItem.getField(...)换成你真正常用的字段加入自己的章节结构造你的第一份[Item]模板解决你最痛的那个场景——可能是文献速读卡也可能是周报汇总。最后送你一句话模板的厉害之处从来不在代码有多花哨而在于它能不能让明天的你少熬一次夜。先解决一个小痛点剩下的交给时间。【免费下载链接】zotero-better-notesEverything about note management. All in Zotero.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-better-notes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考