# A theorem number is a promise

When a lecture says Theorem 2.1, the PDF and the web page must say Theorem 2.1 too. How the numbers are kept, and checked against the numbers LaTeX itself printed.

Address: https://intex.academy/notes/theorem-numbers

November 17, 2026

"By Theorem 2.1" is a small promise: there is one Theorem 2.1, and this is it. The student reading the web page, the classmate with the PDF and the lecturer at the board must all land on the same statement.

Conversions break that promise more often than they seem to, because LaTeX numbers by rules that are easy to miss. In the lecture notes we use as an example, LaTeX printed Definition 1.1, Lemma 1.2 and Theorem 2.1, with equations (1) and (2).

Each number follows a rule of its own. The definition and the lemma share one counter, so the lemma is 1.2, not 1.1. The theorem starts again in section 2. The equations ignore sections altogether. A converter that numbers each kind on its own, or restarts the equations with each section, produces a document that reads well and points to the wrong places.

Our PDF and web page carry LaTeX's numbers, and we know because the build of this site asks LaTeX: it runs the source through LaTeX, reads the number LaTeX wrote down for every label, and compares each with ours. Every one matched. The comparison, row by row, is on [Numbers that match](https://intex.academy/numbers).

On the web page the promise is also a link. A reference to the theorem is named for what it points to, so a screen reader listing the page's links hears the theorem's name and number rather than a bare digit.

More notes: [all notes](https://intex.academy/notes/), or follow them with the [Atom feed](https://intex.academy/notes/feed.xml).
