How to Set Up Pandoc and Pandoc Reference List Plugin for Obsidian

After you have done all the needed steps to connect Zotero and Obsidian, you will be able insert citations easily while you write in Obsidian by simply calling up your Zotero library through the Command Palette or through one of your assigned Hotkeys.

However, as mentioned in my tutorial on How to Connect Zotero 7 to Obsidian (MacOS), the results of this process are pretty basic and will not enable you to automatically generate Reference Lists (RL) based on the citations that have been inserted in your text body. This is where the Pandoc Reference List plugin comes in.

Not only does it link your citations to your references to make export easier and enables the automatic generation of RLs, it also provides a running list of references on your right sidebar on Obsidian and allows for hovering over a citation to quickly see its corresponding reference. Most importantly, at least for me, this plugin reduces friction from looking up and inserting citations because you don't need to bring up the Zotero Search Bar anymore. You can just type in '@' and search from your text body.

Notwithstanding all of these benefits, it requires (you guessed it) a bit of setup (which you probably came here looking for anyway).

Here's a video of what it should look like after you're done (shameless plug of my own article, sorry not sorry?):

Screen Recording 2025-07-08 at 10.50.20 AM.gif

Pandoc and Pandoc Reference List Plugin Setup

This plugin requires installing Pandoc on your system. The easiest way is to go to their GitHub and download the appropriate installer. Again, Choose the arm64-macOS package if you're using Apple Silicone chips (M1, M2, etc.) and choose the x86 package for Intel/older chips. Just follow the prompts and you'll be good to go. Check for correct installation on Macs by opening a Terminal window (CMD + Space then search for Terminal) and typing:

 pandoc --version

Information on the current version installed should come up then. This hasn't failed me yet but if it does for you, then consulting the Pandoc Help Page may be your best bet.

Like all Obsidian Community Plugins, you can search for and install Pandoc Reference List from Settings > Community Plugins > Browse. Don't forget to enable the plugin.

Once it's been enabled, you have to set your settings:

which pandoc

Once this is set up, your citekeys (those thingamajigs that have @ in front of them, representing references in your Zotero Library) will show up as human-friendly citations and will be easily exportable in a reference list. More on how to set up your exporting workflow in my Obsidian to MS Word Academic Workflow ft. the Enhancing Export Plugin.