TeXposit Tutorial

13. LaTeX Verification & Error Checking

Catch errors before compilation with automated verification.

7 min read Share

TeXposit checks your document for errors, inconsistencies, and style issues before you compile. This catches problems that would otherwise surface only after a failed build.

The Five Verification Layers

1. Syntax Checking (Braces & Environments)

Detects structural LaTeX errors before compilation:

  • Unbalanced Braces: Missing {} that would cause parsing errors
  • Mismatched Brackets: [\textbf without closing ]
  • Environment Pairs: \begin{align} without matching \end{align}
  • Citation Errors: Shows red wavy lines under problematic citations

Example Error: Writing \section{Introduction (missing closing brace) is caught immediately and highlighted in neutral gray.

2. Citation Validation

Ensures all citations in your document exist in your bibliography:

  • Missing References: \cite{einstein2023} warns if einstein2023 isn't in your .bib file
  • Unused Entries: Shows warnings for bibliography entries you're not citing
  • Duplicate Keys: Alerts you if two entries share the same citation key

3. Label & Reference Checking

Catches orphaned references and duplicate labels:

  • Undefined Labels: \ref{fig:missing} warns if you haven't defined \label{fig:missing}
  • Duplicate Labels: Two figures with \label{fig:result} will be flagged
  • Broken Cross-References: Helps maintain document structure integrity

4. Style & Quality Checks

Inspired by academic style tools like paperlint, warns about:

  • Missing Figure Captions: Figures without \caption
  • Float Ordering: Captions after figures (should be before or after consistently)
  • Duplicate Citations: Same paper cited multiple times in a row
  • Math Formatting: Numbers in math mode should use \num for consistency
  • Quotation Consistency: Warns if you mix "double" and `single' quotes
  • TODO Detection: Highlights \TODO or % TODO: comments

5. Package Requirement Detection

Automatically identifies which packages you need:

If you write \textcolor{red}{text}, TeXposit warns that you're missing \usepackage{xcolor} and offers to add it automatically.

How to Use Verification

View All Issues

Open the Problems Panel (View → Problems or Cmd+Shift+M) to see a centralized list of all detected issues, organized by severity (error, warning, info).

Inline Indicators

Problems appear inline in your editor:

Critical indicators: Errors that will prevent compilation
Standard indicators: Warnings about potential issues
Subtle indicators: Informational suggestions

Quick Fix Suggestions

Hover over any error to see a tooltip with a quick fix button. Click to automatically resolve common issues:

  • Add missing closing brace
  • Add missing package import
  • Remove duplicate labels

Disabling Specific Checks

If you want to ignore certain warnings in specific files:

LaTeX
% texposit: disable citation-warnings
% texposit: disable todo-detection

Your content here...
Pro Tip: The Verification-Compile Loop

Fix all red errors (shown in the Problems panel) before compiling. This saves compilation time and prevents cryptic LaTeX error messages.