Zotero Deep Linker

by bionux
5
4
3
2
1
Score: 50/100

Description

An Obsidian desktop plugin that searches the local Zotero library and insert hyperlink. Used to jump directly from Obsidian to the corresponding entry or PDF in Zotero.

Reviews

No reviews yet.

Stats

1
stars
296
downloads
0
forks
55
days
26
days
26
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
6
commits

Latest Version

a month ago

Changelog

  1. 添加了zotero笔记的超链接,由于zotero协议原因无法直接打开笔记,只能显示笔记的定位
  2. 修复了设置不显示的错误
  3. 可以选中文本,为文本增加zotero超链接
  4. 不处于条目下的附件在文件夹中可以显示并且链接

README file from

Github

Zotero 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.

Screenshot

Use

  1. Keep Zotero running and enable Settings → Advanced → API → Enable local API (default port 23119, i.e. http://127.0.0.1:23119).
  2. In an Obsidian Markdown note, run Zotero Deep Linker: Add Zotero Deep Link from the command palette, or use the chain-link ribbon button.
  3. 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.
  4. 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, default http://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