mathjax-go

mathjax-go is a native Go port of the MathJax 3.2.2 TeX-to-SVG pipeline used by D2. Its production packages do not embed, load, or execute JavaScript.

The compatibility target is D2's frozen custom component, not current MathJax. That component enables the base, mathtools, ams, amscd, braket, cancel, cases, color, gensymb, mhchem, and physics TeX packages and uses SVG output with fontCache: 'none'.

svg, err := mathjax.Render(`\frac{1}{2}`)
width, height, err := mathjax.Measure(`\frac{1}{2}`)

Render uses the same conversion settings as D2: display mode, a 16-pixel em, an 8-pixel ex, and inline SVG glyph paths. RenderWithOptions exposes those settings explicitly. Both functions return the bare <svg> element that D2 previously obtained from the inner HTML of MathJax's <mjx-container>. Measure preserves D2's pixel sizing contract by rounding the SVG's ex-based dimensions up with the configured default of 8 pixels per ex.

As in MathJax, malformed or unsupported TeX is normally rendered as an merror SVG. A Go error instead indicates invalid conversion options or an internal pipeline failure.

Compatibility tests

The regular suite is pure Go:

go test ./...
go test -race ./...
go vet ./...

An optional test-only differential runner compares the port with D2's cryptographically pinned MathJax bundle. Node.js and the JavaScript assets are used only by this oracle and are not linked into the Go library:

MATHJAX_GO_ORACLE_DIR=/absolute/path/to/d2renderers/d2latex \
MATHJAX_GO_ORACLE_FULL=1 \
go test ./...

The directory must contain mathjax.js, polyfills.js, and setup.js with the exact SHA-256 values recorded in PROVENANCE.md.

License

Apache License 2.0, with identified MIT-derived portions. See LICENSE, LICENSES, NOTICE, and PROVENANCE.md.