Zotero Better Notes Guide

Zotero Better Notes Guide

Overview

Zotero Better Notes transforms Zotero from a reference manager into a full-featured research knowledge management system. With over 7,000 GitHub stars, it is one of the most popular Zotero plugins, addressing a critical gap in the academic workflow: the connection between reading papers and building structured knowledge.

The plugin introduces a powerful note editor with bidirectional linking, templates, and syncing capabilities directly within Zotero. Instead of jumping between Zotero and external note-taking applications like Obsidian or Notion, researchers can maintain their notes alongside the papers they reference, preserving the tight coupling between sources and ideas.

Better Notes supports Markdown editing, note templates, outline views, and export to external systems. It integrates with Zotero's annotation system so that highlights and comments made while reading PDFs can flow directly into structured notes. This creates a seamless pipeline from reading to writing that significantly reduces friction in the research process.

Installation and Setup

Install Better Notes through the standard Zotero add-on mechanism:

1. Download the latest .xpi release from https://github.com/windingwind/zotero-better-notes/releases
2. In Zotero, go to Tools > Add-ons > gear icon > Install Add-on From File
3. Select the .xpi file and restart Zotero

Initial configuration steps:

• Open Zotero Preferences > Better Notes
• Set your preferred note template directory (a local folder for custom templates)
• Configure the default note template for new notes
• Enable or disable auto-insert of annotations into linked notes
• Set up sync preferences if you want notes to export to an external folder
• Choose your preferred Markdown editor behavior and keyboard shortcuts

For researchers using external knowledge bases, configure the sync feature:

• Set a sync target directory (e.g., your Obsidian vault or a shared folder)
• Choose the sync format (Markdown with YAML frontmatter recommended)
• Configure auto-sync frequency or use manual sync triggers
• Map Zotero fields to frontmatter keys for consistent metadata

Core Features

Enhanced Note Editor: Better Notes replaces the default Zotero note editor with a Markdown-capable editor that supports rich formatting, code blocks, mathematical notation, tables, and more. The editor provides a live preview mode and an outline panel for navigating long notes.

Note Templates: Create and manage reusable note templates for different types of research activities:

• Paper reading templates with sections for summary, methods, findings, and critique
• Literature review templates that aggregate information across multiple papers
• Meeting notes templates for lab meetings and conference sessions
• Project planning templates with task tracking and milestone sections

Templates support dynamic variables that auto-populate with item metadata:

# ${title}
**Authors**: ${authors}
**Year**: ${year}
**Journal**: ${publicationTitle}

## Summary

## Methods

## Key Findings

## Relevance to My Research

Bidirectional Linking: Create links between notes using a wiki-style [[note title]] syntax. This builds a knowledge graph within your Zotero library, allowing you to trace connections between concepts, papers, and ideas. The backlinks panel shows all notes that reference the current note.

Annotation Integration: When you highlight text or add comments in the Zotero PDF reader, Better Notes can automatically insert these annotations into a designated note for that item. Annotations are formatted with citation links back to the exact page and location in the PDF.

Outline View: A dedicated outline panel displays the heading structure of your current note, providing quick navigation for long documents. This is especially useful for literature review notes that may span dozens of pages.

Note Export and Sync: Export notes as Markdown files to any directory on your system. The sync feature can automatically keep an external folder up to date with your Zotero notes, enabling integration with tools like Obsidian, Logseq, or any Markdown-based system.