【免费下载】 Zotero Better Notes 笔记模板使用与编写完全指南

什么是笔记模板

Zotero Better Notes 的笔记模板功能允许用户创建可复用的笔记结构，通过预定义的格式和脚本自动生成笔记内容。这一功能特别适合需要频繁创建结构化笔记的研究人员和学生，可以显著提高文献管理和知识整理的效率。

模板的基本使用

导入现有模板

1. 复制模板内容（YAML或JSON格式）
2. 在Zotero菜单栏中选择"工具"->"从剪贴板新建模板"
3. 确认导入

导入后，在笔记编辑器的工具栏中点击"插入模板到当前行"，即可选择并使用已导入的模板。

分享你的模板

1. 通过菜单打开"笔记模板编辑器"
2. 在模板列表中选择要分享的模板
3. 点击"选项"->"复制分享代码"

模板编写详解

模板结构

每个模板包含两个主要部分：

• 名称：以[类型]开头，如[Item]、[Text]等
• 内容：实际的模板代码，支持Markdown/HTML和JavaScript

特殊指令(Pragma)

以// @开头的特殊注释行，用于控制模板行为：

• @use-markdown：声明使用Markdown语法
• @use-refresh：允许通过"从模板更新内容"功能更新生成的内容
• @author：标明模板作者
• @link：模板发布页面的链接
• @${stage}-begin/end：定义不同处理阶段的代码块（仅Item模板）

脚本支持

模板支持嵌入JavaScript代码实现动态内容：

1. 单行代码：用${代码}包裹

   当前时间：${new Date().toLocaleString()}
   

2. 多行函数：用${{代码}}$包裹

   ${{ 
     const a = 1;
     const b = 2;
     return a + b; // 输出3
   }}$
   

模板类型

1. Item模板：处理一个或多个文献条目，支持三个阶段：

   • beforeloop：循环前执行一次
   • default：对每个条目执行一次
   • afterloop：循环后执行一次

2. Text模板：基本用户模板，没有阶段区分

3. 内置模板：系统预定义的模板，名称不可修改

样式语法参考

推荐使用Markdown编写样式：

元素	语法示例
标题	# 一级标题
加粗	**加粗文本**
斜体	*斜体文本*
下划线	<u>下划线文本</u>
删除线	~~删除文本~~
代码	`代码`
代码块	多行代码
高亮文本	<span style="background...">
数学公式	$E=mc^2$ (行内)

实用脚本片段

以下是一些常用的JavaScript代码片段，可直接用于模板：

1. 获取文献标题

   ${topItem.getField("title")}
   

2. 获取作者列表

   ${topItem.getCreators().map(au => au.firstName + " " + au.lastName).join("; ")}
   

3. 获取DOI链接

   [${topItem.getField("DOI")}]("https://doi.org/${topItem.getField('DOI')}")
   

4. 获取标签列表

   ${topItem.getTags().map(tagObj => tagObj.tag)}
   

5. 生成带PDF链接的(作者, 年份)引用

   ${{
     const creators = topItem.getCreators();
     let content = "";
     const year = topItem.getField("year");
     if (creators.length === 0) {
       content = "无作者";
     } else if (creators.length === 1) {
       content = `${creators[0].lastName}, ${year}`;
     } else {
       content = `${creators[0].lastName} 等, ${year}`;
     }
     return `<a href="${await sharedObj.getPDFLink(topItem)}">${content}</a>`;
   }}$
   

最佳实践建议

1. 明确模板用途：在名称中使用[类型]前缀清晰标识模板用途
2. 添加作者信息：使用@author和@link便于用户反馈
3. 合理分阶段：对于Item模板，利用三个阶段组织代码结构
4. 错误处理：在脚本中添加适当的错误检查
5. 性能优化：避免在循环中执行耗时操作
6. 样式一致性：保持生成的笔记风格一致

通过掌握这些技巧，你可以创建出功能强大且易于维护的笔记模板，极大提升在Zotero中的知识管理效率。