Math Equations
KaTeX math equation support using the MathBlock JSX component.
When math is enabled in settings (default: false), you can render mathematical equations using KaTeX via the <MathBlock> JSX component.
Note
math: true requires installing the optional peer katex (pnpm add katex) — create-zudo-doc does not add it for you. See Configuration — math for the full optional-peer contract (katex for math, diff for Document History).
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/).
Inline Math
Use <MathBlock latex="..." /> (without the block prop) to embed math within a line of text.
The formula is inline.
The formula <MathBlock latex="E = mc^2" /> is inline.Block Math
Add the block prop to render a centered display equation.
<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:
export default defineConfig(
zudoDoc({
// ...
math: true, // disabled by default; also `pnpm add katex`
}),
);More Examples
Quadratic Formula
<MathBlock latex="x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}" block />Summation
<MathBlock latex="\sum_{i=1}^{n} i = \frac{n(n+1)}{2}" block />Matrix
<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 />