ZotLit：Obsidian 与 Zotero 联动，有 [@ 就够了
用 Obsidian 做笔记，同时又用 Zotero 管理各种文献的同学可能需要两者相互连接。
Obsidian 和 Zotero 的插件开发者们已经提供了很多解决方案，比如：
- Zotero Integration
- Citations 配合 Zotero Mdnotes
只要爱折腾，反正总有办法。
曾以为要一直这样折腾下去，直到我遇到了由 AidenLx 大佬开发的 Obsidian ZotLit，才发现它能完美满足我的需求。
联动需求
我想要的 Obsidian + Zotero 工作流是这样的：
- 用 Zotero 阅读电子书、RSS，做注释、做笔记；
- 用 Obsidian 做其他任何笔记，记录想法；
- 所有笔记都可在 Obsidian 这边访问；
- 可在 Obsidian 中插入文献引用、导入 Zotero 笔记和注释。
就这点需求，用 ZotLit 非常舒服。
下面简单说说这个插件的功能和设置。
基本信息
插件的基本信息如下（来自 Obsidian ZotLit）。
插件名片
两键引用
- 在 Obsidian 笔记中输入两个键：
[@ - 在弹出的搜索框中搜索文献，回车！
引用格式可自定义。
两步导入
- 打开命令面板选择 “ZotLit: Open quick switcher for literature notes”，回车！
- 弹出搜索框，搜索文献，回车！
立马跳转到 Zotero 导出内容（如果不存在会立即创建并导出）。
公式也能正常显示
导出的注释都是 Markdown，放在引用块中，公式显示完全没问题。
注释装进侧面板
- 打开命令面板，选择 “ZotLit: Open Zotero annotation view in side panel”，回车！
- 在右边侧面板中选择注释链接模式。
- 弹框，搜索，回车！
注释全部出现在侧面板，还有颜色！
在 Zotero 中修改注释会实时更新到 Obsidian。
从 Obsidian 可跳转到 Zotero PDF 注释所在页面。
笔记可分别导出
- 打开命令面板选择 “ZotLit: Import note”，回车！
- 弹框，搜索，回车！
- 选择要导出的笔记，回车！
有多个 Zotero 笔记时可以选择导出其中一个。
自用配置
详细配置方法在 ZotLit 官方文档中都能找到，附上两个有用的链接：
下面分享一下我自己的配置。
安装
- Zotero 中，安装以下两个插件：
- Obsidian 中，在社区插件里找到 “ZotLit”，安装。
ZotLit 模板文件
ZotLit 把从 Zotero 导出的包含笔记、注释等所有信息的 Markdown 称为文献笔记（literature note）。这个文献笔记的文件名、内容等都可以通过模板来调整。
PDF 注释的导出格式也可以通过模板调整，灵活度很高。
所有模板都可以从 ZotLit 设置的 “Template” 选项卡打开。
目前我主要用到这几个模板：
- 文献笔记名（Note filename），定义导出文献笔记的 Obsidian 笔记名。
- 文献笔记内容（Note content），定义导出文献笔记要包含哪些 Zotero 条目内容。
- 主要引用格式（Primary Markdown citation），定义在 Obsidian 中的 citation 格式。
文献笔记模板
所有模板都使用 Eta 编写，上手可能会遇到很多困难，可以参考官方文档 模板基础知识 – ZotLit 和 模板速查表 - ZotLit。
下面的文献笔记模板可以导出作者、日期、Zotero 笔记、PDF 注释等信息。
# <%= it.title %>
> [!INFO]
> - **Authors**: <%=
it.authors
.map(author => `[[${author}]]`)
.join(', ')
%>
> - **Date**: <%= it.date ?? it.year %>
> - **DOI**: <%= it.DOI %>
> - **Groups**: <%= it.collections %>
> - **Tags**: <%= it.tags
.map(tag => '#' + tag.toString().replaceAll(' ', '-'))
.join(', ')
%>
> - **Links**：[Zotero](<%= it.backlink %>), <%= it.fileLink %>
<% it.notes.forEach(note => { -%>
<%= `${note}` %>
<% }) %>
# 注释
<%~ include("annots", it.annotations) %>导出文献笔记的效果如下。
后记
自从用了 ZotLit，满脑子都是 [@ [@ [@ [@，再也回不去了~
