設定で `math` が有効になっている場合（デフォルト：`false`）、`<MathBlock>` JSX コンポーネントを使用して KaTeX で数式をレンダリングできます。

[Dynamic content unavailable in text export]

`math: true` にするにはオプショナルピア `katex` のインストールが必要です（`pnpm add katex`）— `create-zudo-doc` は自動で追加しません。オプショナルピアの契約全体（数式には `katex`、[ドキュメント履歴](https://zudo-doc.takazudomodular.com/ja/docs/guides/doc-history)には `diff`）については、[設定 — math](https://zudo-doc.takazudomodular.com/ja/docs/guides/configuration#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%B3%E3%83%84%E3%81%A8-i18n-math) を参照してください。



[Dynamic content unavailable in text export]

`$...$`、`$$...$$`、および `` ```math `` フェンスは **zfb では非対応です**。zfb の Rust MDX エミッタはこれらの構文を処理しません — 代わりに `<MathBlock latex="..." />` を使用してください（パッケージが公開する [`@takazudo/zudo-doc/math-block`](https://github.com/zudolab/zudo-doc/blob/main/packages/zudo-doc/src/math-block) を参照）。



## インライン数式

`<MathBlock latex="..." />`（`block` プロップなし）を使用して、テキスト内に数式を埋め込みます。

数式 [Dynamic content unavailable in text export] はインラインで表示されます。

```mdx
数式 <MathBlock latex="E = mc^2" /> はインラインで表示されます。
```

## ブロック数式

`block` プロップを追加すると、中央揃えのディスプレイ数式をレンダリングできます。

[Dynamic content unavailable in text export]

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

## 設定

数式サポートは `zfb.config.ts` の `math` フィールドで制御されます：

```ts title="zfb.config.ts"
export default defineConfig(
  zudoDoc({
    // ...
    math: true, // デフォルトでは無効。加えて `pnpm add katex` が必要
  }),
);
```

## その他の例

### 二次方程式の解の公式

[Dynamic content unavailable in text export]

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

### 総和

[Dynamic content unavailable in text export]

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

### 行列

[Dynamic content unavailable in text export]

```mdx
<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 />
```