Zotero Better Notes 笔记模板使用与编写完全指南

经梦鸽

于 2025-06-06 09:21:43 发布

阅读量466

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00406/article/details/148467801

Zotero Better Notes 笔记模板使用与编写完全指南

zotero-better-notes Everything about note management. All in Zotero. 项目地址: https://gitcode.com/gh_mirrors/zo/zotero-better-notes

什么是笔记模板

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

模板的基本使用

导入现有模板

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

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

分享你的模板

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

模板编写详解

模板结构

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

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

特殊指令(Pragma)

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

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

脚本支持

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

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

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

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

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

模板类型

Item模板：处理一个或多个文献条目，支持三个阶段：
- beforeloop：循环前执行一次
- default：对每个条目执行一次
- afterloop：循环后执行一次
Text模板：基本用户模板，没有阶段区分
内置模板：系统预定义的模板，名称不可修改

样式语法参考

推荐使用Markdown编写样式：

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

实用脚本片段

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

获取文献标题
```
${topItem.getField("title")}
```

获取作者列表

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

获取DOI链接

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

获取标签列表

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

生成带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>`;
}}$