Open a Zotero PDF in Obsidian
Open a Zotero PDF attachment in Obsidian's own PDF reader, from a literature note, the quick switcher, or Zotero.
If you are opening your first PDF, follow Annotate Zotero PDFs in Obsidian (about 10 minutes).
Read a Zotero item's PDF in an Obsidian tab instead of switching to Zotero.
ZotLit opens the PDF in Obsidian's own PDF reader, whether the file sits inside your vault or in Zotero's storage folder. Only PDF attachments open this way; EPUBs, web snapshots, and other file types stay in Zotero.
You need Obsidian 1.15.1 or later, which ZotLit 2.2.3 requires.
From a literature note
With the literature note open in Obsidian:
- Open the command palette and run ZotLit: Open PDF.
- Or right-click the note's tab and choose Open PDF from the zotlit section of the file menu.
From the annotation view
Open the view's pane menu and choose Open PDF. This opens the attachment the view shows. The menu leaves the entry out while the view follows that PDF's tab in Obsidian.
From the Library View
In the Library View, double-click a paper's row, or select it and press Shift+Enter. To keep the library in view, right-click the row and choose Open PDF to the right. The Reading Card's Open PDF button opens it too.
From the quick switcher
Run ZotLit: Open literature note quick switcher, search for the item, and press Shift+Enter on the result. The PDF opens without the literature note. See the Literature note quick switcher reference for every chord a result takes.
From Zotero
These entry points need ZotLit Companion, the Zotero add-on, at the version released with ZotLit 2.2. Install ZotLit Companion has the current version.
- In the library, select one PDF attachment, or one item that has a PDF, and choose Open PDF in Obsidian from the top-level context menu.
- While reading a PDF in Zotero, right-click inside the page and choose Open PDF in Obsidian. This opens the PDF you are reading.
From a link in a note
Each annotation ZotLit writes into a note links back to Zotero with a durable link. Click one and the PDF opens in Obsidian, with that annotation selected and scrolled into view. The link works on every computer: when this one does not hold the PDF, Zotero opens the annotation instead. An annotation Zotero no longer has still opens the PDF on its page. See Zotero open links for every case.
A literature note's fileLink writes a link straight to the attachment file, and a click opens that PDF in Obsidian. Notes from an earlier ZotLit link each annotation to the file as well. Those links keep opening in Obsidian on the annotation.
File links work for any link in your vault that points at a PDF in your Zotero library, however the link got there. A link to any other file — an EPUB, a web snapshot, a PDF Zotero does not know about — opens in your system app as before.
To open one link in your system app anyway, right-click it and choose Open in default browser. An annotation link then opens in Zotero. To turn the whole behavior off, clear Open PDF file links in Obsidian in Settings → ZotLit → Reader.
To send annotation links alone to Zotero, clear Settings > ZotLit > Reader > Open annotation links in ZotLit reader. Hovering an annotation link still shows the annotation.
Both settings also apply to the page link on an annotation card and on a Query View row. While either setting is off, that page link opens the annotation in Zotero.
Hover over an annotation link in Live Preview, Source mode, or Reading view to see a popover preview. It shows the quoted text, your comment, the page number, and the highlight color. For an image or ink annotation, it displays the visual excerpt. Below the annotation, the popover shows the bibliography entry of the annotation's item, with the same actions as a citation popover. An annotation on a standalone PDF has no item, so its popover shows the annotation alone. The preview shows on every hover, whatever the citation hover settings are.

What you get
When the item has one PDF, it opens straight away. When it has several, ZotLit asks which one to open; the picker lists them by file name and its search box reads Select a PDF to open.
When the item has no PDF, ZotLit shows This item has no PDF attachment. When the file is no longer on disk, it shows The PDF file is missing. In neither case does ZotLit open the file in Zotero instead.
The annotation view comes forward in the sidebar with the PDF, so the item's highlights appear beside it. While the view is in Active tab mode, it follows the PDF tab.
To keep your sidebar as it is, turn off Settings > ZotLit > Reader > Reveal the annotation view. See Settings.
Keep the read time in Zotero
If you already granted Write Authorization with Allow editing and Always Allow, reading a PDF from My Library in Obsidian updates its last-read time in Zotero. The paper then appears in Zotero's Recently Read list, and the read time syncs through Zotero.
ZotLit does not ask for Write Authorization while you read. Without it, with Zotero closed, or if the update fails, the read still counts on this device and no notice appears. Reads of group-library PDFs in Obsidian also stay on this device.
See also
How to edit PDF annotations in Obsidian
Create or change Zotero annotations while reading in Obsidian.
Use the annotation view
Browse an item's highlights beside the PDF and drag them into your notes.
Create and open literature notes
Open or create a literature note from the quick switcher, a citation, or Zotero.
Commands
Every ZotLit command, with the entry points that reach it.
Last updated on