README file from
GithubZotero Deep Linker for Obsidian
中文版 | English
An Obsidian desktop plugin that searches the local Zotero library and inserts Markdown links to a bibliographic item, a PDF attachment, or one specific PDF annotation.

Use
- Keep Zotero running and enable Settings → Advanced → API → Enable local API (default port 23119, i.e.
http://127.0.0.1:23119). - In an Obsidian Markdown note, run Zotero Deep Linker: Add Zotero Deep Link from the command palette, or use the chain-link ribbon button.
- Search by title, author, DOI, or keyword, or select a Zotero collection in the tree beside the results to browse it directly. Both are available in the same window. Standalone PDF attachments and standalone notes also appear in the list, marked with their own icon so they are not mistaken for items.
- Choose Item, PDF / Annotation, or Note. The subtitles show how many PDFs, annotations, and notes the entry has. A standalone PDF goes straight to its own PDF/annotation targets.
The link text defaults to the item's title; for annotations it is
Title (page N), and for notes Title - Note N (a standalone note, having no
parent title, uses its own text). If you select text in the editor before
running the command (or clicking the ribbon), that selection is used as the link
text instead.
The inserted targets have these forms:
[Title](zotero://select/library/items/ITEM_KEY)
[Title](zotero://open-pdf/library/items/PDF_KEY)
[Title (page N)](zotero://open-pdf/library/items/PDF_KEY?page=PAGE&annotation=ANNOTATION_KEY)
[Title - Note 1](zotero://select/library/items/NOTE_KEY)
The plugin never changes Zotero items, PDFs, or annotations. It only reads the local API and inserts a link into the current Obsidian editor.
Requirements
- Obsidian ≥ 1.8.0 (desktop only)
- Zotero desktop running with Local API enabled
(Settings → Advanced → API → Enable local API, defaulthttp://127.0.0.1:23119) - No other Obsidian plugins required
- No Zotero plugins/extensions required
Settings
The default Zotero Local API address is http://127.0.0.1:23119. Change it
from Settings → Community plugins → Zotero Deep Linker only if your Zotero
setup uses a different local address.
The same settings page includes Collection Column Min Width. Its default is 150 px and it can be increased when your collection names are longer.
Language
UI language follows Obsidian's language setting:
- English (default)
- Chinese (when Obsidian language is set to Chinese)
Development
npm install
npm run build
License
MIT