Streamline Academic Writing with VS Code + Zotero + Git

April 16, 2025

Check this out

Pretty neat, right?

What you just saw above was the ability to save an article off the web, and immediately cite it in your paper. This guide will show you how to configure Visual Studio Code (VS Code), Git, and Zotero together to automate your workflow and make writing a breeze. Most likely, the big question on your mind is “Why should I switch from Overleaf?”, so consider the following:

Work entirely offline
Git integration means neat collaboration + version history (something overleaf tries to do, but locks most of it behind a paywall)
No more compilation timeouts
A fully customizable environment

If any of this sounds interesting to you, then read on!

Pre-requisites

This guide is aimed at macOS users, but the References section includes some resources for Windows users. Some other requirements include:

A basic understanding of writing in LaTeX.
A free Zotero account, with the desktop app and browser “connector” extension
VS Code downloaded.

Table of Contents
Getting a LaTeX Distribution
LaTeX and Git on VS Code
Setting up Zotero
Working with a Sample Document
Tips
- Useful VS Code Extensions:
- Settings \& Tricks
References

Getting a LaTeX Distribution

All the work will be done on VS Code, but we need a distribution of LaTeX behind the curtain for VS Code to use. TeXLive is strongly recommended for working with LaTeX-Workshop, a VS Code extension we’ll set up later, and the easiest way to do this for macOS machines is with MacTex. You can find the download link here, but note this distribution will take almost 10 GB of space.

The size is mainly because TeXLive contains many packages and fonts. If you’d like a lighter weight distribution, LaTeX-Workshop has some alternatives under the Requirements section.

Once the MacTeX.pkg is downloaded, open it and follow the install instructions. At the Installation Type step, select Customize and make sure only TeXLive-2025 is selected. There is no issue installing the other GUI components, but we will functionally replace them with VS Code, so they aren’t needed.

LaTeX and Git on VS Code

With our LaTeX ready, we need to get VS Code to work with it. The power of VS Code’s customization and tools come from its Extensions Marketplace, which we’ll demonstrate how to access now.

Open the primary side bar (View > Appearance > Primary Side Bar), and click the extensions icon.
From there, enter James-Yu.latex-workshop in the search bar, select the result, and click Install.
- We’ll put it to use later in this guide, but we need to prepare Zotero first.

$Screenshot of VS Code, with the left sidebar open to the extensions tab, and James-Yu.latex-workshop entered in the extensions search bar. The editor window has the LaTeX Workshop extension open$

While we’re here, install these other extensions to boost our Git capabilities:

Github Repositories (GitHub.remotehub)
Github Pull Requests (GitHub.vscode-pull-request-github)
GitLens (eamodio.gitlens)

Setting up Zotero

As you saw in the intro, we want our setup to auto-export a newly saved citation to wherever our project is. To do this we'll need Better BibTeX, which has easy install instructions here. As mentioned, make sure you are installing this in the standalone Zotero application. If you're new to Zotero and haven't made a collection yet, open the app and click the Add Collection icon in the upper-left corner of the window. Now in your browser when you find a cool new paper, like this one on the GlueX Detector, you can use the Zotero browser extension to easily save it to your collection.

$Screenshot showing the Add Collection icon placed above the My Library drop-down menu$

$Screenshot of an arxiv page, with the Zotero browser extension GUI open in the upper right-hand corner$

Working with a Sample Document

To best see the capabilities of Git and Zotero, we’ll need a LaTeX document to test it out on.

Do you already have a working LaTeX project in mind? On the Welcome editor tab you can select Open and navigate to your project’s home folder, or select Open Folder from the Explorer tab on the sidebar.
- If you haven’t already, select Initialize Repository from the source control tab in the primary side bar to activate Git tracking. This is the same as running git init in the terminal.
Otherwise, you can use this sample project off of github. Follow the instructions at the bottom of the linked page to download it and open it in VS Code.
- Note that it will automatically suggest the extensions listed in this tutorial and have a project-specific settings.json with the settings I’ll suggest later.

The LaTeX-Workshop extension includes a LaTeX tab in the Primary Side Bar. Select it, and you’ll notice among other options the button to $\textcolor{green}{\triangleright}$ Build LaTeX project. Whenever you make changes to your project, click this to enact those changes and create the main.pdf output file. If you’re most familiar with Overleaf, this is equivalent to the Recompile option. If you want to mimic the Overleaf style view, use the Split Editor Right button and position your output pdf to the right, like below.

$Screenshot of VS Code's split editor view with the main.tex file on the left, and the output pdf on the right$

Now that we know our LaTeX build works, let’s take a quick look at what Git can do for us.

VS Code Git Basics

If you’ve made any edits to your document, you may have noticed an $\textcolor{#9E8D71}{\text{M}}$ appear next to your filename, and some textures appear next to the line numbers that can expand to show you changes.

$Screenshot of VS Code with the sidebar open to Source Control, and changes made to the LaTeX document highlighted$

If you navigate to the Source Control tab in the primary side bar, you’ll see that file is now listed under Changes. This tab is essentially your git status view, where you can view changes and commit them, and push or pull commits from a remote repository. You can access old commits, allowing you to view and even revert to older versions of your project. If you’re entirely new to Git, VS Code has a guide going over the basics.