Local Zotero Mirror

approved

by wsqstar

Synchronize Zotero collections, paper metadata, and native notes into local Markdown notes. - This plugin has not been manually reviewed by Obsidian staff.

★ 1 stars↓ 298 downloadsUpdated 1mo agoMIT
Install in ObsidianView on GitHub

Local Zotero Mirror

Local Zotero Mirror is an Obsidian desktop plugin that syncs Zotero collection structure, paper metadata, and Zotero native notes into local Markdown notes.

It is designed to work with the companion Zotero plugin, Local Zotero Bridge.

Features

  • Creates one canonical Markdown note per Zotero item.
  • Regenerates collection index notes that link to canonical paper notes.
  • Preserves user-written note sections outside managed blocks.
  • Migrates Zotero native notes into a protected Markdown block.
  • Writes a local full-text search index for Zotero-side Obsidian note search.
  • Converts Zotero source tags into Obsidian-safe zotero/... tags while preserving originals in zotero_tags.
  • Supports opening Zotero items and PDF attachments from Obsidian commands and context menus.
  • Renders Pandoc-style citations such as [@smith2024] as APA parenthetical citations in reading mode.
  • Shows a virtual References block in reading mode based on citekeys used in the current note.

Installation and Updates

For BRAT, add this repository URL inside Obsidian: https://github.com/Mappedinfo/local-zotero-mirror. BRAT installs and updates from GitHub Releases.

Development

npm install
npm test
npm run build

Obsidian Release Assets

A GitHub release should upload:

  • main.js
  • manifest.json
  • styles.css

The release tag must match manifest.json.version exactly for Obsidian community plugin distribution.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.