Create your first literature note
A hands-on walkthrough: open your Zotero library in Obsidian, read a paper beside it, and write a literature note with its metadata and annotations.
This tutorial walks you from your Zotero library to your first literature note. You will open the library in Obsidian, read a paper's PDF with your Zotero highlights on the page, and then write a note for the paper beside it. By the end, you will have a Markdown note with the paper's title, a link back to Zotero, and the annotations you made on the PDF.
Before you start
Install ZotLit. ZotLit finds your Zotero database automatically from your Zotero profile, and Zotero does not need to be open.
Open your library
Open the Library View
On a new install, ZotLit opens the Library View for you, in a tab titled Zotero 文库. Otherwise, select the ZotLit icon in the ribbon, or open the command palette (Ctrl+P on Windows/Linux, Cmd+P on macOS) and run:
A setup banner may sit above the list. You can leave it there for now: once its 连接到 Zotero step is done, ZotLit is reading your library.
If the view shows 未找到 Zotero instead of your papers, select 定位数据文件夹 and choose your Zotero data folder.
Find a paper you have highlighted
For this tutorial, choose a paper that already has annotations, the highlights and notes you made in the Zotero PDF reader. That way you can see them in Obsidian.
In the buttons below the tree on the left, select 有批注. If you do not see the tree, select the 显示文库和分类 button beside the search box, then scroll down the tree to reach the buttons. Dismissing the setup banner gives the list more room. The list now shows only the papers you have annotated. To look for one paper, type part of its title in the 搜索文献 box.
Select the paper
Click the paper's row. The Reading Card opens on the right of the view, laid out like the paper's first page: its title, authors, and journal, then its abstract when Zotero has one, and last its annotations, with the first two shown; select the link under them to show them all. On a narrow pane, it opens under the list.
Read the paper
Open the PDF beside the library
Right-click the paper's row and choose 在右侧打开 PDF.
The PDF opens in a new pane to the right of the library. ZotLit does not copy the file into your vault.
See your highlights
The highlights and notes you made in Zotero are already on the page, in the same colors. The Zotero 标注 view also opens in the right sidebar and lists each annotation as a card.
Write the note
Write the note in a new tab
Click the paper's row in the library again. Then press Ctrl+Enter (Cmd+Enter on macOS).
ZotLit writes the literature note and opens it in a new tab in front of the library. The PDF stays in its pane on the right, so you can read on one side and write on the other. You will see a brief notice: 文献笔记已创建。
If ZotLit asks which profile to use, choose 默认.
Plain Enter writes the same note, but opens it in the pane beside the library, in place of the PDF.
See the result
The note appears in a literatures folder in your vault (the default location). It contains:
- A heading with the paper's title
- A link back to the item in Zotero
- Links to its attached files
- An Annotations section with your PDF highlights and notes
The note's filename is the item's citation key by default.
ZotLit also saves small zotlit-excerpt-….webp image files at the vault root. These are excerpt images it keeps for your annotations, and you can leave them there.
ZotLit built this note from the Default profile, the built-in one that decides a note's name, folder, properties, and body. Read about profiles to see what you can change.
What you are looking at
ZotLit writes this body once, when it creates the note. From then on the body is yours to edit. The Annotations section is a live view, so new highlights appear without an update.
To update the note later, open it and run ZotLit: 更新笔记 from the command palette. A dialog opens. Select 更新当前笔记.
ZotLit refreshes the note's properties and leaves the body as you wrote it. To learn the other ways to update, read Keep notes up to date.
The Default note has no managed region, so its body stays as you write it. To see how notes that use a managed region work, read Literature notes and the managed region.
Opening an existing note
Back in the library, the paper's row now shows that it has a literature note. Select the row and press Enter again, and ZotLit opens the existing note instead of creating a duplicate.
You can also reach any paper's note without the library: run ZotLit: 打开文献笔记快速切换器 from the command palette and search for the paper.
What's next
Now that you have a literature note with annotations, you can cite it in a document or change how annotations look when you insert them.
Write and export a cited note
Insert a citation, review its reference, and export a Word document with a formatted bibliography.
Customize your annotations
Edit a template to change how callouts render, then insert an annotation into your note.
Browse your library in the Library View
Every control of the Library View: the tree, Recent, search, filters, the Reading Card, and the row menu.
Open an item's PDF in Obsidian
Every way to open a paper's PDF in Obsidian, and what you see when it opens.
Last updated on