Showcase: Boosting Docusaurus math rendering performance with 3.5KB native MathML

[x-at-01]

Docusaurus websites are highly customizable and optimized for SEO. However, many documentation sites that render heavy mathematical formulas rely on KaTeX or MathJax. This brings notable overhead:

• Asset Overhead: Packing large JS files and a full set of fonts slows down Docusaurus's initial Page Load Speed.
• Hydration & DOM Size: Thousands of absolute-positioned nested span tags are created to simulate equations.

Why not transition to native MathML?
With universal support for MathML Core in Chromium, WebKit, and Firefox since 2023, Docusaurus can compile math equations directly to standard <math> tags.

We developed @webc.site/math, a 3.5KB TeX-to-MathML compiler:

• Ultra-Lightweight: Only 3.58 KB (Gzip, zero dependencies) to bundle or run during the MDX compilation phase.
• Build-Time Compilation: Renders LaTeX directly to HTML tags, shipping zero JS layout overhead to the reader's browser.
• Native Rendering: Leverages the browser's native math engines to typeset equations beautifully.

This makes a perfect plugin alternative for Docusaurus docs to keep page sizes minimal while retaining crisp formula rendering!