zudo-doc
GitHub repository

Type to search...

to open search from anywhere

Math Equations

Created Mar 14, 2026Updated Jul 10, 2026Takeshi Takatsudo

KaTeX math equation support using the MathBlock JSX component.

When math is enabled in settings (default: true), you can render mathematical equations using KaTeX via the <MathBlock> JSX component.

Info

$...$, $$...$$, and ```math fences are not supported in zfb. The zfb Rust MDX emitter does not process those syntaxes — use <MathBlock latex="..." /> instead (shipped as @takazudo/zudo-doc/math-block).

Inline Math

Use <MathBlock latex="..." /> (without the block prop) to embed math within a line of text.

The formula E=mc2E = mc^2 is inline.

The formula <MathBlock latex="E = mc^2" /> is inline.

Block Math

Add the block prop to render a centered display equation.

ex2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
<MathBlock latex="\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}" block />

Configuration

Math support is controlled by the math field in zfb.config.ts:

zfb.config.ts
export default defineConfig(
  zudoDoc({
    // ...
    math: true, // enabled by default
  }),
);

More Examples

Quadratic Formula

x=b±b24ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
<MathBlock latex="x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}" block />

Summation

i=1ni=n(n+1)2\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
<MathBlock latex="\sum_{i=1}^{n} i = \frac{n(n+1)}{2}" block />

Matrix

[abcd][xy]=[ax+bycx+dy]\begin{bmatrix} a & b \\ c & d \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} = \begin{bmatrix} ax + by \\ cx + dy \end{bmatrix}
<MathBlock latex="\begin{bmatrix} a & b \\ c & d \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} = \begin{bmatrix} ax + by \\ cx + dy \end{bmatrix}" block />

Revision History

Takeshi TakatsudoCreated: 2026-03-14T21:08:12+09:00Updated: 2026-07-10T01:57:17Z

AI Assistant

Ask a question about the documentation.

Preview theme

Loading theme previews…