Writing Math with LaTeX

Wed, 15 Jul 2026 10:00:00 +0800

Beacon supports LaTeX math. Equations are typeset at build time with KaTeX (via Hugo’s transform.ToMath), so no JavaScript is shipped to readers — the KaTeX stylesheet is only included on pages that actually contain math.

Inline math

Wrap inline expressions in $ and $. For example, the identity $e^{i\pi} + 1 = 0$ holds, and the golden ratio is $\varphi = \frac{1 + \sqrt{5}}{2} \approx 1.618$ .

Plain dollar signs are left alone, so writing about a $5 coffee or a $10 lunch is safe.

Shortcodes: Math, Music, and Sponsor

Tue, 14 Jul 2026 10:00:00 +0800

Beacon ships a few shortcodes for richer posts. Everything below renders from a short tag in the Markdown — no manual HTML.

Math (LaTeX)

Beacon typesets LaTeX with KaTeX at build time — the equations are baked into the HTML, so there is no client-side JavaScript and no flash of unstyled math.

You can write math two ways. The first is bare delimiters (needs the Goldmark passthrough extension, which this demo enables): the Pythagorean theorem $a^2 + b^2 = c^2$ sits inline, and a display block reads:

Math on Beacon Demo

Writing Math with LaTeX

Inline math

Shortcodes: Math, Music, and Sponsor

Math (LaTeX)