TPIX
HomePackagesNamespacesUpload

Zotero Sync

Zotero Sync lets you automatically export your Zotero bibliographies in BibTeX, BibLaTeX, or Hayagriva format for use in your Typst documents. Both CLI and Typstify is supported.

Workflow

  1. Connect your Zotero account — Go to Settings → Zotero on the TPIX web page and enter your Zotero API key.

  2. Create export targets in Typstify — Use Typstify to create bibliography exports from your Zotero libraries and collections. Typstify will poll TPIX for updated bibliographies, so you'll always have the latest version.

  3. Use in Typst — Reference your bibliography in your document:

    # bibliography("reference-name.bib")

The sync uses Zotero's version tracking to efficiently fetch only changes since your last export.

Format Options

  • BibTeX — Standard bibliography format, compatible with most LaTeX workflows
  • BibLaTeX — Extended format for use with BibLaTeX
  • Hayagriva — Typst-native bibliography format, recommended for Typst documents

Personal vs Namespace Use

Personal Use

Connect your Zotero account from your user settings page (/settings/zotero/). Your API key provides access to all your personal and group Zotero libraries, and only you can access the exported bibliographies.

Namespace Use

Namespace owners can connect a Zotero account to their namespace settings (/namespaces/{namespace}/settings). This allows all namespace members to access the exported bibliographies.

Differences:

  • All namespace members can access exports
  • Optional Sync Personal Library flag — when enabled, only group Zotero libraries (not personal libraries) are synced. This is useful if you don't want personal library contents to be shared with namespace members.

Usage in Typst:

# bibliography("local-references.bib")