Write LaTeX
Apply the LaTeX conventions from the reference files below when creating or editing LaTeX source.
Core Principles
- Semantic markup over visual hacks -- use the right command for its meaning, not for its appearance
- Standard compliance -- follow AMS, ISO 80000-2, and IEEE conventions
- No deprecated constructs -- never use
$$,eqnarray,\def,\centerline,\over, or two-letter font commands - Macro discipline -- define
\newcommandmacros for recurring notation so a single edit propagates everywhere
Workflow
- Review against the essential checklist:
./references/essential/checklist.md - For specific questions, consult the comprehensive references below
Reference Navigation
Quick reviews (default):
references/essential/checklist.md-- condensed, actionable rules
Deep dives by topic:
references/comprehensive/math-typesetting.md-- display math, environments, operators, delimiters, fractions, ellipsis, mathtoolsreferences/comprehensive/iso-conventions.md-- ISO 80000-2: variables, constants, vectors, differential notation, custom macrosreferences/comprehensive/tables.md-- booktabs, caption placement, column alignment, complete examplesreferences/comprehensive/bibliography.md-- BibTeX: capital protection, DOI, journal abbreviations, backrefreferences/comprehensive/packages.md-- recommended packages with load order: mathtools, cleveref, hyperref, siunitx, microtype, and morereferences/comprehensive/spacing-and-alignment.md-- math spaces, phantom alignment, intertext, Knuth's @ techniquereferences/comprehensive/common-mistakes.md-- deprecated commands and their modern replacementsreferences/comprehensive/figures-and-floats.md-- graphics formats, subcaption, float placement, caption conventionsreferences/comprehensive/macros-and-cross-refs.md-- macro design, cleveref cross-references, label prefixesreferences/comprehensive/document-conventions.md-- equation punctuation, enumitem lists, unbreakable spaces, hyperref metadata
Sources
- Downes, M. and Beeton, B. Short Math Guide for LaTeX. AMS, 2017.
- IEEE. Math Typesetting Guide for LaTeX Users.
- Higham, N. J. Blog posts on tables, BibTeX, packages, spacing, ISO typesetting, ellipses, lists, and book writing. 2013--2021.
- Beeton, B. "How to Typeset Equations in LaTeX." TUGboat 18(1), 1997.
- Chen, E. LaTeX Style Guide. web.evanchen.cc.
- Ensenbach, M. et al. l2tabu: A List of Don'ts in LaTeX.
- Voss, H. Mathmode. CTAN.
- Mittelbach, F. and Fischer, U. The LaTeX Companion. 3rd ed., 2024.
- MathSciNet. Serials Abbreviations.