Latex ecosystem guide

LaTeX Ecosystem Guide

Overview

LaTeX remains the gold standard for typesetting academic documents in mathematics, computer science, physics, and engineering. Its precise control over document layout, equation rendering, and bibliography management makes it indispensable for journal and conference submissions.

This guide consolidates the best resources from the awesome-LaTeX repository (1,600+ stars) into an actionable reference covering editors, essential packages, document classes, bibliography management, and workflow optimization. Whether you are a LaTeX beginner setting up your first paper or an experienced user looking to streamline your pipeline, this skill provides the tools and techniques you need.

The LaTeX ecosystem is vast -- over 6,000 packages on CTAN alone. Rather than cataloging everything, this guide focuses on the packages and tools that researchers use most frequently and the workflows that save the most time.

Editors and IDEs

Editor Comparison

Editor	Platform	Real-time Preview	Collaboration	Free
Overleaf	Web	Yes	Real-time	Yes (limited)
TeXstudio	Desktop	Compile-based	No	Yes
VS Code + LaTeX Workshop	Desktop	Yes (SyncTeX)	Live Share	Yes
Texifier	macOS/iOS	Live	No	Paid
Vim + VimTeX	Terminal	Zathura/Skim	No	Yes

Recommended Setup: VS Code + LaTeX Workshop

// .vscode/settings.json
{
  "latex-workshop.latex.autoBuild.run": "onSave",
  "latex-workshop.latex.recipe.default": "latexmk (xelatex)",
  "latex-workshop.latex.recipes": [
    {
      "name": "latexmk (xelatex)",
      "tools": ["latexmk-xelatex"]
    }
  ],
  "latex-workshop.latex.tools": [
    {
      "name": "latexmk-xelatex",
      "command": "latexmk",
      "args": [
        "-xelatex",
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOC%"
      ]
    }
  ],
  "latex-workshop.view.pdf.viewer": "tab"
}

Essential Packages

Document Structure

\usepackage[margin=1in]{geometry}    % Page margins
\usepackage{setspace}                 % Line spacing
\usepackage{fancyhdr}                 % Headers and footers
\usepackage{titlesec}                 % Section heading styles
\usepackage[hidelinks]{hyperref}      % Clickable cross-references
\usepackage{cleveref}                 % Smart cross-references (\cref)

Mathematics

\usepackage{amsmath}      % Core math environments
\usepackage{amssymb}      % Extended symbols
\usepackage{amsthm}       % Theorem environments
\usepackage{mathtools}    % Extensions to amsmath
\usepackage{bm}           % Bold math symbols

Figures and Tables

\usepackage{graphicx}     % Include images
\usepackage{subcaption}   % Subfigures
\usepackage{booktabs}     % Professional tables (\toprule, \midrule, \bottomrule)
\usepackage{multirow}     % Multi-row cells
\usepackage{siunitx}      % SI units and number formatting

Code Listings

\usepackage{listings}     % Basic code listings
\usepackage{minted}       % Syntax-highlighted code (requires Pygments)
\usepackage{algorithm2e}  % Algorithm pseudocode

Document Classes for Research

Class	Use Case	Key Feature
article	Short papers, preprints	Standard LaTeX
revtex4-2	APS journals (Phys Rev)	Built-in journal styles
IEEEtran	IEEE conferences/journals	Two-column, IEEE format
acmart	ACM conferences/journals	Multiple formats (sigconf, sigplan)
elsarticle	Elsevier journals	Preprint and journal modes
svjour3	Springer journals	Springer Nature format
aaai	AAAI conference	AAAI formatting

Example: ACM Conference Paper

\documentclass[sigconf,review]{acmart}

\begin{document}
\title{Your Paper Title}
\author{First Author}
\affiliation{%
  \institution{University Name}
  \city{City}
  \country{Country}
}
\email{[email protected]}

\begin{abstract}
Your abstract here.
\end{abstract}

\maketitle
\section{Introduction}
...
\end{document}

Bibliography Management

BibLaTeX + Biber (Recommended)

\usepackage[
  backend=biber,
  style=numeric-comp,
  sorting=none,
  maxbibnames=99
]{biblatex}
\addbibresource{refs.bib}

% In document body:
As shown in prior work~\cite{vaswani2017attention}...

% At the end:
\printbibliography

Quick Reference: BibTeX Entry Types

@article{key,
  author  = {Last, First and Last2, First2},
  title   = {Paper Title},
  journal = {Journal Name},
  year    = {2024},
  volume  = {42},
  pages   = {1--15},
  doi     = {10.xxxx/xxxxx}
}

@inproceedings{key2,
  author    = {Last, First},
  title     = {Conference Paper Title},
  booktitle = {Proceedings of Conference},
  year      = {2024},
  pages     = {100--110}
}

Workflow Automation

Makefile for LaTeX Projects

MAIN = paper
TEX = $(MAIN).tex
PDF = $(MAIN).pdf

.PHONY: all clean watch

all: $(PDF)

$(PDF): $(TEX) refs.bib
	latexmk -xelatex -interaction=nonstopmode $(TEX)

clean:
	latexmk -C

watch:
	latexmk -xelatex -pvc -interaction=nonstopmode $(TEX)

Git Integration for LaTeX

# .gitignore for LaTeX projects
*.aux
*.bbl
*.blg
*.log
*.out
*.synctex.gz
*.fdb_latexmk
*.fls
*.toc
*.nav
*.snm

Best Practices

• Use latexmk instead of manual compilation chains. It handles multi-pass compilation automatically.
• Prefer booktabs for tables. Never use vertical lines (|) in academic tables.
• Use \cref{} from cleveref. It automatically prepends "Figure," "Table," or "Equation."
• Keep one sentence per line in source files. This makes Git diffs readable and merges cleaner.
• Pin your TeX distribution version. Use Docker or Nix to ensure reproducible builds across machines.
• Store figures as PDF or SVG for vector graphics, PNG for raster. Never upscale low-resolution images.

References

• awesome-LaTeX -- Curated list of LaTeX resources (1,600+ stars)
• CTAN -- Comprehensive TeX Archive Network
• LaTeX Wikibook -- Community-maintained reference
• Overleaf Documentation -- Tutorials and templates
• LaTeX Workshop for VS Code -- VS Code extension