latex-ecosystem-guide

Installation
SKILL.md

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{author@university.edu}

\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

Related skills
Installs
2
GitHub Stars
212
First Seen
Apr 2, 2026