reference-manager-interop
Move and sync reference libraries between Zotero, Mendeley, EndNote, JabRef, Paperpile and writing tools (LaTeX/BibTeX, Word, Google Docs, Pandoc, Quarto, Overleaf). Use when converting RIS, BibTeX, BibLaTeX or CSL-JSON files, migrating a library, setting up auto-exported .bib files, choosing a citation style (CSL), or fixing citations lost between tools. Includes a zero-dependency BibTeX/RIS/CSL-JSON converter.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- reference-manager-interop
- license
- MIT
- metadata
- { "tags": "Zotero, Mendeley, EndNote, JabRef, BibTeX, RIS, CSL-JSON, Pandoc, Quarto, Overleaf, reference manager", "author": "Kalaris Labs (Sayan Chowdhury)", "version": "1.0", "category": "literature-review", "maintainer": "Kalaris Labs" }
- description
- Move and sync reference libraries between Zotero, Mendeley, EndNote, JabRef, Paperpile and writing tools (LaTeX/BibTeX, Word, Google Docs, Pandoc, Quarto, Overleaf). Use when converting RIS, BibTeX, BibLaTeX or CSL-JSON files, migrating a library, setting up auto-exported .bib files, choosing a citation style (CSL), or fixing citations lost between tools. Includes a zero-dependency BibTeX/RIS/CSL-JSON converter.
- compatibility
- Python 3.9+ standard library for scripts/convert_refs.py; Pandoc optional for rendering with CSL styles.
02 资源文件 1
- 脚本scripts/convert_refs.py10.8 KB
03 SKILL.md 正文
Reference Manager Interoperability
Every reference manager speaks at least one of three interchange formats:
| Format | Best for | Notes |
|---|---|---|
BibTeX / BibLaTeX (.bib) |
LaTeX, Overleaf, JabRef | BibLaTeX adds @online, @dataset, @software, UTF-8 via biber |
RIS (.ris) |
EndNote, Mendeley, Scopus/WoS/PubMed exports | Tag-per-line, loses some structure (e.g. corporate authors) |
CSL-JSON (.json) |
Pandoc, Quarto, Zotero, citeproc-js, Word/Docs plugins | The richest interchange format, native to citation styles |
Convert between formats
python scripts/convert_refs.py library.ris references.bib # EndNote/Mendeley -> LaTeX
python scripts/convert_refs.py references.bib references.json # LaTeX -> Pandoc/Quarto
python scripts/convert_refs.py export.json out.ris --from csljson --to ris
Conversion is lossy for exotic fields. Always diff counts (grep -c "^@" refs.bib,
grep -c "^TY -" lib.ris) and spot-check authors with particles (van, de, von)
and corporate authors. Then run the bibtex-hygiene linter on any produced .bib.
Tool-specific recipes
Zotero (recommended hub)
- Install the Better BibTeX plugin, then right-click a collection → Export → Keep updated
to write an auto-refreshing
.bibnext to the manuscript with stable citation keys. - Programmatic access: the
pyzoteroskill (Zotero Web API; needs a user API key). - Word/Google Docs: the Zotero connector plugins insert live citations and bibliography.
Mendeley Reference Manager
- Export: select references → Export → BibTeX (
.bib), RIS or EndNote XML. - To migrate to Zotero: import the
.ris/.bibexport, or use Zotero's built-in Mendeley importer. - Don't build new automation against Mendeley's web API. Work from exported files instead.
EndNote
- Export: File → Export with output style "RefMan (RIS) Export" (
.ris) or XML. - Import
.risback with the "Reference Manager (RIS)" filter. Check the encoding is UTF-8.
JabRef: native BibTeX/BibLaTeX. Use Quality → Cleanup entries and Check integrity before submission.
Overleaf: link a Zotero/Mendeley account or upload the .bib. With an auto-exported
Better BibTeX file, re-upload it or sync via Git.
Rendering citations with CSL styles (Pandoc / Quarto)
pandoc paper.md --citeproc --bibliography references.json --csl nature.csl -o paper.docx
Quarto front matter:
bibliography: references.json
csl: apa.csl # fetch from https://github.com/citation-style-language/styles
Pick the exact style file for the target journal from the CSL repository (over 10,000 styles). Never approximate a journal's style by editing a similar one unless none exists.
Migration checklist
- Export from the source tool in its richest format (CSL-JSON or native XML > RIS > BibTeX).
- Record the reference count before and after.
- Convert with
scripts/convert_refs.pyif the target cannot import the source format. - Import, then check 10 random entries for authors, title case, container, year, DOI.
- Re-attach PDFs separately. Attachments never travel inside RIS/BibTeX/CSL-JSON.
- Rebuild citation keys only if the manuscript does not already cite the old keys.
Related skills
bibtex-hygiene, citation-verification, citation-management, pyzotero.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.