Zotero-Better-Notes常见问题解答：新手入门必看

安装与基础设置

如何安装Zotero-Better-Notes插件？

1. 下载最新版本的.xpi文件（例如better-notes-for-zotero.xpi）
2. 在Zotero中依次点击工具 > 插件
3. 点击右上角齿轮图标，选择从文件安装插件
4. 选择下载的.xpi文件完成安装

⚠️ 注意：Firefox浏览器可能会自动打开.xpi文件，建议使用右键菜单选择"另存为"下载文件

支持哪些Zotero版本？

插件仅支持Zotero 7及以上版本，旧版用户需先升级Zotero主程序。

笔记编辑器使用

如何打开笔记编辑器？

有三种方式可访问笔记编辑器：

• 双击库中的笔记项打开独立标签页
• 选中项目后在右侧信息面板中查看/编辑笔记
• 在PDF阅读器中使用右侧上下文面板的笔记功能

按住Shift键双击笔记可在新窗口中打开，方便多文档对比编辑。

什么是"魔法键(Magic Key)"？

魔法键是插件增强的命令面板，通过以下方式触发：

• 在编辑器中输入/
• 使用快捷键Ctrl/Cmd + /

面板支持搜索命令、插入模板、执行脚本等功能，是提升效率的核心工具。

如何在笔记间创建链接？

1. 点击笔记编辑器标题栏的链接图标（📎）
2. 在弹出窗口中选择目标笔记
3. 选择链接类型：
   • Mention in：在目标笔记中插入当前笔记的链接（入站链接）
   • Link to：在当前笔记中插入目标笔记的链接（出站链接）

💡 提示：按住Ctrl/Cmd键并悬停链接可预览目标笔记内容

模板系统

什么是笔记模板？

笔记模板是可复用的内容生成工具，支持：

• 自动提取文献元数据（标题、作者、DOI等）
• 批量汇总多个文献的关键信息
• 通过JavaScript脚本实现自定义逻辑

如何导入社区模板？

1. 复制模板的YAML或JSON代码
2. 在Zotero中依次点击工具 > 从剪贴板新建模板
3. 在弹出窗口中确认模板信息，点击确定完成导入

示例模板格式：

name: "[Item] 文献摘要模板"
content: |-
  // @use-markdown
  // @author Your Name
  # ${topItem.getField("title")}
  
  **作者**：${topItem.getCreators().map(au => `${au.lastName} ${au.firstName}`).join("; ")}
  **发表年份**：${topItem.getField("year")}
  **DOI**：[${topItem.getField("DOI")}](https://doi.org/${topItem.getField("DOI")})

如何使用模板生成内容？

1. 在笔记编辑器中点击工具栏的模板按钮
2. 从下拉菜单中选择所需模板
3. 如模板需要输入项，在弹出的项目选择器中选择文献
4. 生成内容将自动插入到当前笔记中

高级功能

如何设置笔记与Markdown文件同步？

1. 在笔记编辑器中点击导出按钮
2. 选择"Markdown"格式并设置保存路径
3. 勾选"启用自动同步"选项
4. 设置同步间隔时间（默认30秒）

同步机制：当关闭编辑器或达到同步间隔时，插件会双向更新Zotero笔记和本地Markdown文件。

支持哪些导出格式？

插件提供多种导出选项：

• Markdown（支持嵌入式/链接式图片）
• Microsoft Word (.docx)
• PDF文档
• FreeMind思维导图 (.mm)
• LaTeX源文件

导出按钮位于笔记编辑器工具栏，可根据需求选择格式并调整导出选项。

如何使用多标签页/窗口管理笔记？

插件突破了Zotero原生限制，支持：

• 无限打开笔记标签页
• 拖放标签页调整顺序
• 按住Shift键双击笔记打开独立窗口
• 所有窗口/标签页内容实时同步

常见问题排查

插件安装后不显示怎么办？

1. 确认Zotero版本是否为7.0以上
2. 检查插件是否启用：工具 > 插件，确保"Better Notes"已勾选
3. 重启Zotero尝试解决加载问题
4. 如仍未解决，删除旧版插件并重新安装最新版本

模板执行失败如何处理？

模板执行失败通常有以下原因：

• 模板语法错误：检查JavaScript代码是否正确
• 权限问题：预览模式下无法修改数据库
• 字段不存在：文献缺少模板所需的元数据字段

解决方法：使用模板编辑器检查语法，或尝试使用社区验证过的模板。

笔记同步冲突如何解决？

当Zotero笔记与本地Markdown文件同时修改时：

1. 同步时会显示差异对比窗口
2. 可选择保留Zotero版本、保留文件版本或手动合并
3. 建议定期备份重要笔记，避免数据丢失

实用技巧

提高效率的快捷键

功能	Windows/Linux	Mac
打开魔法键面板	Ctrl + /	Cmd + /
插入模板	Alt + T	Option + T
导出笔记	Ctrl + E	Cmd + E
新建笔记	Ctrl + N	Cmd + N

推荐的入门模板

1. 文献摘要模板：快速提取文献核心元数据
2. 阅读笔记模板：结构化记录文献重点、疑问和思考
3. 文献对比模板：横向比较多篇文献的研究方法和结论
4. 会议笔记模板：按时间线或主题组织会议内容

可在社区模板库中搜索并导入这些模板（访问社区模板库需遵守相关规定）。

如何自定义编辑器工具栏？

1. 在笔记编辑器中右键点击工具栏
2. 选择"自定义工具栏"
3. 拖放按钮调整顺序或添加新功能按钮
4. 点击"完成"保存设置

总结

Zotero-Better-Notes通过增强笔记编辑、模板系统和知识连接功能，显著提升了Zotero的知识管理能力。新手用户建议从模板系统和笔记链接功能入手，逐步探索高级特性。如有更多问题，可查阅插件文档或参与社区讨论。