v2.2.0-beta.1

This beta lets you read and annotate your Zotero PDFs in Obsidian, next to the note you are writing, and every mark you make is saved in Zotero.

HighlightsCopy anchor link

Read and annotate your Zotero PDFs in ObsidianCopy anchor link

A Zotero item's PDF now opens in an Obsidian tab beside the note you are writing, so you can read and mark up a paper without switching to Zotero. The PDF stays in Zotero's storage, outside your vault; opening it there needs Obsidian 1.14.2 or later. The highlights and notes you made in Zotero are already on the page, in their Zotero colors. With Zotero 10 or later, what you mark in Obsidian is saved to Zotero, so it syncs and shows in Zotero's reader like any other annotation.

You can open a PDF from several places:

• From a literature note, run ZotLit: 打开 PDF, or choose it from the note's tab menu.
• In ZotLit: 打开文献笔记快速切换器, press Shift+Enter on a result.
• In Zotero, choose 在 Obsidian 中打开 PDF from an item's context menu, or 在 Obsidian 中打开 PDF from the page menu of Zotero's reader. Both need the updated ZotLit Companion.
• Click a file link in a note. The PDF opens on the right page, with the linked annotation selected.

The Zotero 标注 view comes forward in the sidebar with the PDF. To keep your sidebar as it is, turn off Settings > ZotLit > 阅读器 > 显示标注视图. To send file links to your system app again, turn off 在 Obsidian 中打开 PDF 文件链接 on the same page. Only PDFs open in Obsidian; EPUBs and web snapshots stay in Zotero. Open an item's PDF in Obsidian lists every way in.

The toolbar beside the page creates the same annotations as Zotero's reader: 高亮, 下划线, 添加笔记, 添加文本 for text typed onto the page, 选择区域 to capture a figure or table, and 绘图 for freehand strokes. Each tool keeps the color you last chose for it, in every PDF.

Select a mark to change its color, comment, or tags. The comment editor takes bold, italic, subscript, and superscript, as in Zotero. When the PDF's text came out wrong, for example with broken ligatures, 编辑引用文本 on the annotation's card corrects the quoted text. You can drag a mark to move or resize it, and delete an annotation after a confirmation. While the PDF is open, Ctrl+Z (Windows) or Command+Z (macOS) undoes your last annotation change, and redo applies it again. Edit PDF annotations in Obsidian covers each tool and key.

Reading needs no permission. Editing needs four things:

• Zotero 10 or later. With Zotero 9, the PDF opens and shows its annotations, but changes cannot be saved from Obsidian, and ZotLit tells you to update Zotero.
• Zotero is running on the same computer.
• In Zotero, Allow other applications on this computer to communicate with Zotero is on, under Settings → Advanced. ZotLit tells you when it is off.
• ZotLit has your permission, given once. Select 允许编辑 in the annotation view, or 允许编辑 on the Zotero 编辑 row under Settings > ZotLit > Zotero. When Zotero asks, choose Always Allow. Allow alone leaves editing off.

When an annotation changed in Zotero while you were editing it in Obsidian, the card shows 已在 Zotero 中更改 with both versions, and you choose which one to keep. Annotations that Zotero will not let you change are locked in Obsidian too. Examples are annotations Zotero imported from the PDF file itself, and in a group library, annotations another member made. A lock icon on the card gives the reason.

Edit a given annotation in one app at a time, and let each change save before you switch. A known Zotero issue can make one edit silently overwrite the other when both apps change the same annotation.

Breaking ChangesCopy anchor link

Exports cite with the note's own styleCopy anchor link

ZotLit: 导出带引文的笔记 and native Pandoc runs now format citations in the style the note uses in Obsidian. That is the note's own zotlit-csl property, the style of an imported note's profile, or your 参考文献样式. The export dialog says where the style comes from, and the notice at the end names the style it used.

The built-in export used to fall back to a bundled style when Zotero could not supply the one you chose. It now stops and tells you, so a document never comes out in a style you did not pick. Install the style in Zotero, or choose another one in the dialog.

If you run Pandoc yourself with ZotLit's integration files, save them again from this version. The files from earlier versions no longer work with this release. See Export a note with citations and Export with native Pandoc.

What's NewCopy anchor link

Annotation viewCopy anchor link

• The view keeps the follow mode you choose, 活动标签页, Zotero 阅读器, or 已固定, until you change it. When its source has nothing to show, the view says so in place.
• Select several cards with Ctrl-click or Command-click, Shift-click, or Ctrl+A / Command+A. Then delete them, recolor them with the keys 1 to 8, or copy their text together. One undo reverses the whole group.
• 插入到笔记 in a card's menu inserts the annotation at the cursor in your note, the same text a drag leaves, so you can insert from the keyboard as well.
• 打开 PDF in the view's menu opens the attachment on screen in Obsidian.
• 按标签筛选 and 按颜色筛选 open as small popovers, so the filters no longer push the list down.
• Edit an annotation's tags on its card or in the PDF popup, then select 保存标签.
• Image and ink annotations show their picture on the card and insert into notes with both PDF readers closed. The picture updates after you edit the annotation. See Excerpt images.

Use the annotation view has the full guide.

ZotLit CompanionCopy anchor link

• 笔记打开位置, in the 在 Obsidian 中打开 section of the ZotLit pane in Zotero's settings, chooses where notes opened from Zotero's menus appear: 当前标签页, 新标签页, 新标签页组, or 新窗口.
• obsidian://zotlit/ links take the same choice as a paneType parameter: tab, split, or window. See Where the link opens.

Bug FixesCopy anchor link

• In Zotero, right-clicking a PDF attachment opened an empty ZotLit submenu. The submenu is now dimmed when none of its entries apply.
• Converting 2.1 template files: when moving the old files to the trash failed, the conversion is still kept, and ZotLit names the files left behind and tries the cleanup again.
• When ZotLit refuses a template conversion, it now names only the files you need to edit.
• The reminder shown after you postpone the template conversion is shorter.