本页有简体中文版。

阅读中文版
ZotLit

Replace Obsidian's Pandoc Reference List plugin

Move from the Pandoc Reference List plugin to ZotLit in Obsidian and keep your [@key] citations, metadata, and native Pandoc export working.

  1. Citations such as @doe2024, [@doe2024], and [@doe2024, p. 33] keep working as written. Leave them as they are.
  2. Point ZotLit at the same Zotero libraries, and pick the same citation style.
  3. Change each [[@citekey]] link by hand, one at a time.
  4. Turn off Pandoc Reference List and check one note.

Migrate the workflow

Your existing citations stay as written: nothing in your notes has to change except [[@citekey]] links and some note properties. Keep your original notes or a backup copy until you check a note at the end.

  1. In Zotero, check that every paper you cite has a citation key in its Citation Key field. Each cited paper shows a key. Choose your key format before migrating notes, and keep existing keys after the move.
  2. Open Settings > ZotLit > Zotero. Check that Zotero database points to the Zotero profile that holds your cited papers. The database path is the one with your library.
  3. On the same page, under Libraries, set Library scope to All libraries, or choose Selected libraries and add the personal and group libraries you used before. ZotLit searches all of those libraries at once.
  4. Open Settings > ZotLit > Citations. Keep Pandoc citations and Show formatted citations on. Under Formatting, install the Pandoc engine. The engine is installed.
  5. Install your former CSL style in Zotero. Then open Settings > ZotLit and select that style under Citation and references style. Citations in Live Preview use that style.
  6. Back in Settings > ZotLit > Citations, under Formatting, set Citation locale to your language, or leave it empty to keep Style default. Citation terms and dates follow that language.
  7. If you used citation-key tooltips, set Hover action to Citation popover. Hovering a citation shows its reference entry.
  8. Search the vault for [[@. Change each one by hand. No [[@ link is left that you did not mean.
  9. In Settings > Community plugins, turn off Pandoc Reference List. Keep a record of its settings first. Only ZotLit changes how citations look.
  10. Open a note that uses your citations and note properties. Check that its citations show formatted in Live Preview. Run ZotLit: Open references, then select Copy bibliography in the References sidebar. The sidebar lists each cited paper, and the reference list is on your clipboard.

If you see something else

  • The References sidebar shows a Reference Error → fix every Reference Error before you go on; see Review, copy, and troubleshoot references.
  • The sidebar says "@{citekey} matches multiple items in your Zotero library." → two papers share that key, in one library or in two libraries in your scope. ZotLit does not pick one by library order. Give one paper a different key in Zotero, or narrow Library scope; see Ambiguous citation keys.
  • Both plugins change how the citations look → Pandoc Reference List is still on. Turn it off in Settings > Community plugins and test with only ZotLit.
  • The ZotLit filter reports csl-ambiguous → the note has both csl and zotlit-csl. Keep only one of them.

Next

Last updated on

On this page