All posts

Compile errors, explained in plain language

"Undefined control sequence" doesn't tell you what to do next. Luzbase turns common LaTeX errors into a one-line fix and takes you straight to the line that caused it.

A Missing $ inserted LaTeX error, explained by Luzbase in plain language with a Go to button for line 42.
! Missing $ inserted.
<inserted text>
                $
l.42 The learning rate \alpha

If you've used LaTeX for more than a week, you've seen this. If you've used it for more than a year, you know it means "you used a math symbol outside math mode." But that knowledge took time to build, and the log doesn't help newcomers get there.

Luzbase reads the log for you.

What you see instead

When a compile fails, the Output panel lists each error with a short explanation and a fix. The example above shows:

A math-only command or symbol (like ^, _ or \alpha) is outside math. Wrap it in $…$.

Click Go to and the editor jumps to line 42, cursor in place. Fix it, press ⌘Enter, done.

The full log is still one click away under Show full log for the cases where you need it.

The errors it explains

These are the ones that cause most of the frustration, especially for students:

What LaTeX says

What Luzbase tells you

Undefined control sequence (on \toprule)

Add \usepackage{booktabs} to the preamble.

File natbibb.sty not found

The package "natbibb" is not installed. Check the name in \usepackage{natbibb}.

\begin{itemize} on input line 12 ended by \end{document}

\begin{itemize} on line 12 is never closed. Add \end{itemize} before \end{document}.

Missing $ inserted

Wrap the symbol in $…$.

File ended while scanning use of…

A { or an argument is never closed. Check the braces before this point.

Unicode character ≈ (U+2248)

pdflatex can't typeset "≈". Replace it, or compile with XeLaTeX by adding % !TEX program = xelatex as the first line.

BibTeX/biber syntax error

A bibliography entry is malformed: look for a missing comma, brace or quote just before this line.

It also explains the silent failures that confuse people most: an empty bibliography (nothing is cited yet, so add a \cite{…}, or \nocite{*} to list every entry) and a compile that produces no pages at all. If the error happened in a file LaTeX generated, like the .bbl bibliography, it tells you where to fix it in your files instead.

Why it matters

A beginner who hits Missing $ inserted with no help often loses half an hour. Some give up and go back to Word. An experienced author loses less time, but still has to scroll a 400-line log to find the one error that matters.

Plain-language errors fix both problems: the beginner learns the rule, and the expert gets to the line faster.

Catch them before you compile

On Pro, the LaTeX language server checks your document as you type and underlines problems before you ever press Compile: unknown commands, unbalanced braces, labels you reference but never define. We cover it in a separate post.

Try it

Make a mistake on purpose: type x^2 outside math mode and compile. Then see how much faster the fix is when the error tells you what to do.

Start writing free.