[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71333":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":40,"readmeContent":41,"aiSummary":42,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":43,"discoverSource":44},71333,"zotero-better-notes","windingwind\u002Fzotero-better-notes","windingwind","Everything about note management. All in Zotero.","",null,"TypeScript",7851,257,24,2,0,9,28,121,27,38.23,"GNU Affero General Public License v3.0",false,"master",true,[27,28,29,30,31,32,33,34,35,36,37,38,39],"addon","knowledge","markdown","mindmap","note","notes","obsidian","obsidian-md","plugin","zotero","zotero-addon","zotero-plugin","zotero7","2026-06-12 02:02:51","# Better Notes for Zotero\n\n[![zotero target version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FZotero-8%2F9-green?style=flat-square&logo=zotero&logoColor=CC2936)](https:\u002F\u002Fwww.zotero.org)\n[![Using Zotero Plugin Template](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUsing-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github)](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-plugin-template)\n[![telegram group](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20Community-@bnzotero-blue?style=flat-square&logo=telegram)](https:\u002F\u002Ft.me\u002Fboost\u002Fbnzotero)\n\n\u003Cdiv align=center>\u003Cimg src=\".\u002Fdocs\u002Fres\u002Fteaser.png\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\nEverything about note management. All in Zotero.\n\nJoin the community on Telegram: [@bnzotero](https:\u002F\u002Ft.me\u002Fboost\u002Fbnzotero)\n\n## 🧩 Outline\n\n[🧐 What is this?](#-what-is-this)\n\n[🤔 What can it do?](#-what-can-it-do)\n\n[👋 Install](#-install)\n\n[😎 Quick start](#-quick-start)\n\n\u003Cdetails style=\"text-indent: 2em\">\n\u003Csummary>More\u003C\u002Fsummary>\n\n[Getting Started by Opening a Note Tab](#getting-started-by-opening-a-note-tab)\n\n[Note Editor](#note-editor)\n\n[Note Link](#note-link)\n\n[Note Template](#note-template)\n\n[Syncing: Note 🔄️ Markdown](#syncing-note-%EF%B8%8F-markdown)\n\n[Note Export](#note-export)\n\n[GPT Integration](#gpt-integration)\n\n[Action Workflow](#action-workflow)\n\n[Other Features](#other-features)\n\n\u003C\u002Fdetails>\n\n[🧲 API](#-api)\n\n[🔧 Development](#-development)\n\n[🔔 Disclaimer](#-disclaimer)\n\n[🔎 My Zotero Plugins](#-my-zotero-plugins)\n\n[🫶 Sponsors](#-sponsors)\n\n[🤗 Contributors](#-contributors)\n\n## 🧐 What is this?\n\nBetter Notes (BN) is a plugin for [Zotero](https:\u002F\u002Fzotero.org).\n\nBN streamlines your workflows of:\n\n- paper reading\n- annotating\n- note taking\n- metadata analyzing\n- knowledge exporting\n- AI writing assistant\n\nand:\n\n- works out of the box\n- highly customizable\n- all in Zotero\n\n## 🤔 What can it do?\n\n🖇️ Connect knowledge fragments with _note link_. With one click. [Learn more →](#note-link)\n\n🗂️ Simplify and automate knowledge analysis with extensive _note templates_. With one click. [Learn more →](#note-template)\n\n🔄️ Keep in sync with your Markdown files. Two-way, automatically. [Learn more →](#syncing-note-%EF%B8%8F-markdown)\n\n🖨️ Export notes to different formats: Markdown, Docx, PDF, and mind map. [Learn more →](#note-export)\n\n📝 Enhancements for Zotero's note editor with outline, link relation, view images.... Open as much note tabs\u002Fwindows as you like!\n\n## 👋 Install\n\n- Download the plugin (.xpi file) from below (beta version is only for Zotero beta!).\n  - [Latest Stable](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-better-notes\u002Freleases\u002Flatest)\n  - [All Releases](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-better-notes\u002Freleases)\n\n  _Note_: If you're using Firefox as your browser, right-click the `.xpi` and select \"Save As..\"\n\n- In Zotero click `Tools` in the top menu bar and then click `Plugins`\n- Go to the Extensions page and then click the gear icon in the top right.\n- Select `Install Add-on from file`.\n- Browse to where you downloaded the `.xpi` file and select it.\n- Finish!\n\n## 😎 Quick start\n\nBN offers a range of features that can be combined like Lego blocks to build your own note-taking workflow.\n\nStart taking notes in Zotero with BN in **5 minutes**!\n\n### Getting Started by Opening a Note Tab\n\n> 💡 In the latest version, the workspace is no longer a thing. You can open an unlimited number of note tabs\u002Fwindows, which is what we called `workspace` in the past.\n\nTo open a note in a tab, double-click\u002Fpress `Enter` on the item in the library, as you would do to open an attachment. Holding `shift` opens the note in a new window.\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0824293b-765d-47af-8815-66f009adab0e\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\n> **Explore the Note Tab!**  \n> 💡 The layout from left to right is:\n>\n> - Outline\n> - Note editor\n> - Context pane (tags, related, relation graph, in\u002Foutbound links)\n\n### Note Editor\n\n> 💡 Where can I find the note editor?\n>\n> - In the note tab\u002Fwindow\n> - In the library: click to open a note editor in the item pane\n> - In the PDF reader: right-side context pane\n>\n> 💡 How to create a new note?  \n> Click the note icon in the library tools bar (the row under the tabs bar), or from the menu - File\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fec2ba415-8ec9-450d-9d73-d24d177ccd13\" width=\"400px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\n#### Magic Key\n\nBN enhances the note editor with a _Magic Key_ command palette, which can be opened by typing `\u002F` in the editor or pressing `Ctrl\u002FCmd` + `\u002F`. You can type or use the arrow keys to navigate the commands, and press `Enter` to execute.\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fbdbe244e-c120-4d9b-aa28-5285a25a723a\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\n#### Note Link Preview\n\nBN enhances the note editor with link preview. Hover+Ctrl\u002FCmd or click the link to preview the linked note without leaving the current note.\n\n\u003Cdiv align=center>\u003Cimg width=\"400px\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb29769a1-3436-42bd-8481-eee1c0b4896a\">\u003C\u002Fdiv>\n\n#### Direct Markdown Paste\n\nBN supports direct markdown paste. You can paste markdown content into the note editor, and it will be converted to the rich text format automatically.\n\n### Note Link\n\nTo create a _note link_ between the note you are editing and another note, click the \u003Cimg src=\"addon\u002Fchrome\u002Fcontent\u002Ficons\u002Ffavicon.png\" width=\"20px\">\u003C\u002Fimg> button in the title bar of the note editor.\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe37a694b-613e-4242-9c14-d83708a3d1e7\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\n> 💡 What's the difference between `Mention in` and `Link to`?\n>\n> `Mention in` will insert a link of the current note (from which you open the link creator) to another note (which you pick in the link creator), i.e. inbound link.\n> `Link to` will insert links of picked notes to the current note, i.e. outbound link.\n\nYou can also manually copy the note link from the note editor menu.\n\n### Note Template\n\nAre you spending a lot of time writing summaries and copy-pasting while taking notes? Say hello to _Note Template_!\n\n_Note Template_ is designed for tasks like:\n\n- Summarize metadata and annotations from multiple papers, with customized filters\n- Compare papers across sections\n- Generate content programmatically\n\n> 💡 Need help or looking for community templates? [See here →](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-better-notes\u002Fdiscussions\u002Fcategories\u002Fnote-templates)\n>\n> 💡 Want to write\u002Fshare your templates?\n>\n> [How to write →](docs\u002Fabout-note-template.md#write-note-template)\n>\n> [How to share →](docs\u002Fabout-note-template.md#share-your-template)\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F62e1438f-7910-4f57-ad88-c6a41dd9addf\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\n### Syncing: Note 🔄️ Markdown\n\nWith BN, you can integrate your note-taking into your existing workflow seamlessly. If you use markdown editors like Obsidian, you can keep your notes in sync with external Markdown files easily.\n\nTo set up auto-sync, click `Set Auto-Sync` the first time you export your note. There is no need for any third-party tools or complicated setups!\n\n\u003Cdiv align=center>\u003Cimg src=\"https:\u002F\u002Fuser-images.githubusercontent.com\u002F33902321\u002F236622955-9ca54590-d6f8-433a-8622-33b35fc7b79d.png\" width=\"800px\">\u003C\u002Fimg>\u003C\u002Fdiv>\n\nAny changes made to your note or its corresponding Markdown file will be automatically synced. This feature makes it easy to keep all of your notes up to date and in one place.\n\n> 💡 Note: Synchronisation takes place once the editor is closed and after the period of time you set in the `Auto-sync period` preference.\n\n### Note Export\n\nBN offers various options to export your notes, giving you the flexibility to choose the format that suits your needs.\n\nYou can export your note to the following formats:\n\n- A new note in Zotero\n- Markdown file (embedded or linked, with images)\n- MS Word document (.docx)\n- PDF document (.pdf)\n- FreeMind file (.mm)\n\nSimply click on the corresponding export button in the toolbar and follow the prompts.\n\n### LLM Integration\n\nThe [Zotero-GPT](https:\u002F\u002Fgithub.com\u002FMuiseDestiny\u002Fzotero-gpt) plugin provides GPT Integration. If you also have Better Notes installed, you can wake up its chatting pane in the note editor and insert\u002Fmodify content in the note.\n\n### Action Workflow\n\nThe [Actions & Tags](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-actions-tags) plugin provides a powerful workflow engine for Zotero. If you also have Better Notes installed, you can use the following actions to automate note generation\u002Fediting\u002Fsyncing\u002Fetc.:\n\n- [Auto-generate note from template when opening an item](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-actions-tags\u002Fdiscussions\u002F108)\n- [Auto-sync note when opening\u002Fcreating an item](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-actions-tags\u002Fdiscussions\u002F140)\n- [More...](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-actions-tags\u002Fdiscussions\u002Fcategories\u002Faction-scripts)\n\n### Other Features\n\n- Quick Note: convert annotation to note with one click.\n- Resize images with a right-click menu.\n- Preview images with double-click\u002Fctrl-click.\n\n## 🧲 API\n\nBN provides APIs for other plugin developers in `Zotero.BetterNotes.api.${API_MODULE}`. See [`api.ts`](src\u002Fapi.ts).\n\n- `workspace`: Workspace APIs\n- `sync`: Syncing APIs\n- `convert`: Lossless conversion between note, HTML, Markdown, note link, and annotation\n- `template`: Manipulate note templates\n- `$export`: Export note\n- `$import`: Import note\n- `editor`: Note editor APIs. Give your script full control of contents in the note editor.\n- `note`: Note APIs. Parse and manipulate note content.\n- `relation`: Note relation APIs. Get and set note relations.\n- `utils`: Utility functions.\n\n### Concepts about Note-Related APIs\n\nIn Zotero, the content of a note is stored as rich text, while when a note is opened in the note editor, it is rendered by ProseMirror as HTML.\n\nMost of the time, it is recommended to use the `editor` API to interact with the content of the note, as it supports undo\u002Fredo and other features provided by editor. The `editor` API provides a set of powerful functions to analyze and manipulate the content in the note editor. Most of them needs an `editor` instance as the input, you can get the instance by calling `Zotero.BetterNotes.api.editor.getEditorInstance(noteId)`.\n\nHowever, if note is not opened in the editor, you cannot get the `editor` instance. In this case, you can use the `note` API to interact with the content of the note.\n\n## 🔧 Development\n\nThis plugin is built based on the [Zotero Plugin Template](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-plugin-template). See the setup and debug details there.\n\nTo start, run\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-better-notes.git\ncd zotero-better-notes\nnpm install\nnpm run build\n```\n\nThe plugin is built to `.\u002Fbuilds\u002F*.xpi`.\n\nTo debug, run\n\n```bash\nnpm run start\n```\n\nThis will open a new Zotero instance with the plugin installed.\n\nTo test the plugin, run\n\n```bash\nnpm run test\n```\n\nThis will run the tests in the `.\u002Ftest` directory.\n\n## 🔔 Disclaimer\n\nUse this code under AGPL. No warranties are provided. Keep the laws of your locality in mind!\n\n## 🔎 My Zotero Plugins\n\n- [Translate for Zotero](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-pdf-translate): Translate PDF, EPub, webpage, metadata, annotations, notes to the target language.\n- [Actions & Tags for Zotero](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-tag): Customize your Zotero workflow.\n- [Bionic for Zotero](https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fbionic-for-zotero): Bionic reading experience with Zotero.\n\n## 🙌 Sponsors\n\nThanks\n[peachgirl100](https:\u002F\u002Fgithub.com\u002Fpeachgirl100), [Juan Gimenez](),\nand other anonymous sponsors!\n\nIf you want to leave your name here, please email me or leave a message with the donation.\n\n## 🤗 Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fwindingwind\u002Fzotero-better-notes\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=windingwind\u002Fzotero-better-notes\" \u002F>\n\u003C\u002Fa>\n","Better Notes 是一个针对 Zotero 的插件，旨在提升笔记管理的效率与体验。它支持论文阅读、标注、笔记记录、元数据分析、知识导出以及AI写作助手等功能，并且开箱即用，高度可定制。该插件使用 TypeScript 编写，具备强大的笔记链接、模板化知识分析、双向Markdown同步及多种格式导出（如Markdown、Docx、PDF和思维导图）等核心功能。适用于需要在学术研究或个人知识管理系统中高效整合文献管理和笔记整理的场景。","2026-06-11 03:37:14","high_star"]