Note: This plugin is not ready for production yet. Install using the Obsidian BRAT plugin.
Start with the Quick Start Guide!
- Add annotation – Create annotations while viewing the document.
- Copy link to annotation – Grab a direct link to a specific annotation.
- Copy link to selection – Link to any text selection for precise references.
- Annotate with Obsidian’s editor – Annotate with Obsidian's Markdown editor directly!
- Sync Color Theme - Auto Sync the theme with Obsidian.
- Pure Markdown - No extra json, store with pure markdown.
Complete Documentation - Comprehensive guides and references
- Installation Guide - Step-by-step installation
- Quick Start Guide - Get started in 5 minutes
- Template Variables - Customize annotation templates
- Zotero Workflow - Workflow
Make sure you have recent Node.js and npm installed.
One-time setup and full build:
npm install
npm run build:pdf.js
npm run buildActive development (run in parallel, separate terminals/tabs):
npm run dev:reader
npm run dev:pluginbuild:pdf.js– prepares bundled PDF.js assets.dev:reader– runs the zotero reader in watch mode.dev:plugin– builds the Obsidian plugin in watch mode.
Special thanks to the Zotero team for the excellent application that inspired this plugin.
Thanks for checking out the plugin! I’m currently a student and working on this plugin nights and weekends. If it’s useful to you, a small tip will help me keep shipping features.
- If the reader doesn’t open, double‑check the YAML frontmatter is valid and that
sourcepoints to an existing file. - After updating, try disabling/enabling the plugin or reloading Obsidian.
Have ideas or found a bug? Please join the discord server!
