zoteroRoam
Report an issueRoadmap
v0.7
v0.7
  • Introduction
  • ▶️Demo by Cortex Futura
  • 🔄Updating from older versions
  • 🚀Changelog
  • 🆘Help/Getting Support
  • 🏠Getting Started
    • Pre-requisites
    • Basic Setup
  • 🧪Using the extension
    • The search panel
    • In-text references
    • Contextual menus
    • On-page menu
    • The dashboard
    • Web import
  • 🛠️Customizations
    • What's Available
    • Formatting metadata
      • SmartBlock templates
      • JavaScript templates
        • Helper functions
        • Nesting metadata
    • Formatting annotations
    • Formatting notes
    • Keyboard Shortcuts
    • CSS Themes
    • Other Settings
      • Autocomplete
      • Copy Settings
      • Page Menus
      • Scite Badge
      • Typemap
      • Web Import
      • Other
    • Advanced : Event Hooks
    • Advanced : Extension API
  • About the Zotero API
    • Zotero API Docs (v3)
  • Support the project
    • How to support/contribute
    • Buy a (virtual) coffee
    • Sponsor on GitHub
Powered by GitBook
On this page

Was this helpful?

Introduction

A basic run-down of the extension

Last updated 2 years ago

Was this helpful?

This extension started out of a basic use case : importing data from Zotero to Roam based on a citekey.

A number of users in the Roam community, myself included, have adopted a reference system where citekeys are used as page names like so : [[@citekey]]. This allows for a few convenient things like :

  • having a unique, simple handle to reference a literature item within Roam ;

  • being able to cite seamlessly with [[ and filtering suggestions with @ ;

  • being able to write in Roam, and then to export to a formatting tool (Zettlr, Pandoc, etc.) without having to manually reformat references.

Beginning in ~May 2020, enabled Zotero -> Roam data import, using the Zotero desktop client and a JSON file. It's the best solution I know if you're looking to import a lot of library items at once into Roam ; it handles single items, multi-item selection, and collections.

It's been a major inspiration for the development of this extension, in particular with user settings. Though while it's very efficient for bulk data import, it's cumbersome to generate a JSON file when adding just one item. Especially if you repeat the process a few times. It also requires starting from the Zotero app, tracking down which item(s) you haven't imported yet, and a fair amount of context-switching.

Features

  • Import data from Zotero to Roam (metadata, notes/annotations, attachments)

  • Discover connections within your Zotero library

  • Browse citation networks and find new papers, without leaving Roam

  • Integrate your Roam graph, Zotero items, and external tools (Scite, Connected Papers...)

  • Manage your tags into a unified system

The extension assumes the workflow described above, where the [[@citekey]] nomenclature is used, and works best with the as citekey manager.

melat0nin's Zotero export plugin
Better BibTeX plugin