External Publication
Visit Post

Pre-RFC: Rustdoc LaTeX-style math

Rust Internals [Unofficial] April 27, 2026
Source

zackw:

I want to request something of the implementation : Please make sure that the math source code is converted to MathML at render time, and therefore degrades gracefully if katex's JavaScript and/or CSS fail to load. (Last I checked, katex could do this, but it wasn't its default mode.)

Why? According to MathML | Can I use... Support tables for HTML5, CSS3, etc support is universal on all browser versions that are still in use. The only exception is severely outdated Safari versions, since Apple don't ship a newer browser independent of the OS, but I'm not convinced many people check rust docs on their very old phones, and on desktops/laptops they could just use Firefox or Chrome instead

I would much prefer to render to MathML once and not include extra JavaScript at runtime.

Discussion in the ATmosphere

Loading comments...