Skip to main content

ZotFlow 1.1.0

This release rounds out the reading-and-note workflow: manage tags without leaving Obsidian, jump straight to any annotation, navigate child notes more naturally, and enjoy cleaner generated notes.

Updating is safe — your existing notes, templates, and settings keep working, with no migration step required.

Highlights​

  • Edit Zotero item and annotation tags directly from Obsidian — changes sync back to Zotero.
  • Smarter child-note navigation, with a new option to always open notes in the Note Editor or Source Note.
  • Annotation links that open the PDF exactly at the annotation.
  • New template link filters that can point to either ZotFlow or the Zotero app.
  • Fixed stray  -style codes appearing in notes synced from Zotero.

Edit tags without leaving Obsidian​

You can now add and remove tags on Zotero items and annotations right inside Obsidian.

Where to edit tags

  • Tree view — right-click any item and choose Edit tags…
  • Reader (Zotero items) — open the tag editor on any annotation.
  • Reader (local files) — the same tag editor works for annotations on local PDFs and EPUBs.

What the editor does

  • Shows your tags as chips; remove one with its × button, or press Backspace on an empty input to drop the last one.
  • Autocompletes from every tag already used across your libraries; press Enter to add.
  • Offers to create a new tag when what you typed doesn't exist yet.
  • Marks Zotero "automatic" tags visually and leaves them intact.
  • Matches Zotero's behavior exactly — Tag and tag are treated as different tags.

Tags also now show up in your generated notes — in the frontmatter tags: list, beneath each annotation, and in the tree view.

Smarter child-note navigation​

Opening a Zotero child note now takes you to the right place more reliably.

  • By default, a child note opens inside its parent's source note, scrolled to that note's editable region.
  • New setting Always Open Child Notes in Note Editor (Settings → General) opens child notes in the standalone Note Editor instead.
  • New right-click actions on notes in the tree view:
    • Locate in Source Note — jump to the note's region in its parent source note.
    • Open in Note Editor (Experimental) — open the note on its own.
  • Deleting a note now refreshes its parent source note so the removed note's region disappears cleanly.

Open an annotation in one click. Annotation links now resolve to the exact annotation: ZotFlow finds the right PDF and opens the reader scrolled directly to it.

Choose ZotFlow or Zotero for any link. Three template filters let your source notes link wherever you prefer. By default they open inside ZotFlow; pass "zotero" to open in the Zotero desktop app instead. Personal and group libraries are handled automatically.

FilterDefault (ZotFlow)With : "zotero"
attachment_linkOpens the attachment in ZotFlow's readerOpens the attachment in Zotero
annotation_linkOpens the PDF at the annotation in ZotFlowOpens the PDF at the annotation in Zotero
item_linkOpens the item's source noteSelects the item in Zotero

These work in your own custom templates (Settings → Zotero Source Note). A few examples:

Link to an attachment:

- [{{ attachment.filename }}]({{ attachment | attachment_link }})

Open in the Zotero app instead:

- [{{ attachment.filename }}]({{ attachment | attachment_link: "zotero" }})

Annotation callout that jumps to the exact annotation:

> [!zotflow-{{ annotation.type }}-{{ annotation.color }}] [{{ attachment.filename }}, p.{{ annotation.pageLabel }}]({{ annotation | annotation_link }})

Link to a related item's note:

Related: [{{ related.title }}]({{ related | item_link }})

In local attachment templates, attachment_link and annotation_link work the same way (item_link doesn't apply). For example, to make a local annotation callout open in ZotFlow's reader:

> [!zotflow-{{ annotation.type }}-{{ annotation.color }}] [{{ item.name }}, p.{{ annotation.pageLabel }}]({{ annotation | annotation_link }})

Templates also gained a parentItem value on items, attachments, notes, and annotations, which is what powers the new annotation links.

If you've customized your templates, see the template guide for the latest defaults and the full list of available filters.

Cleaner Zotero notes​

Fixed a bug where notes synced from Zotero could show stray codes such as   in the text. ZotFlow now repairs these automatically during conversion, while leaving real symbols — and anything inside code blocks — untouched.