**GitHub Alerts** 機能は、GitHub 形式のアラートブロック引用（README で見かける `> [!NOTE]` 構文）を、[アドモニションレシピ（`directives` マップ）](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/admonitions-preset)が生成するのと同じアドモニションマークアップに変換します。これにより、使い慣れた GitHub 構文でコールアウトを書きながら、`:::note` 形式のディレクティブとまったく同じように描画できます。

:::note[標準プリセットに含まれます]

`zudoDoc()` は GitHub Alerts を有効にします。個別の設定フィールドは不要です。

```ts
// zfb.config.ts
import { defineConfig } from "zfb/config";
import { zudoDoc } from "@takazudo/zudo-doc/config";

export default defineConfig(
  zudoDoc({
    siteName: "My Docs",
  }),
);
```

:::

## 構文

ブロック引用の 1 行目に `[!TYPE]` を前置します（タイプは大文字小文字を区別せずに一致）。

```md
> [!NOTE]
> Useful information that users should know, even when skimming content.
```

## バリアント

5 種類のアラートタイプがサポートされています。それぞれがアドモニションバリアントに対応します。

| 前置            | バリアント  |
| --------------- | ----------- |
| `[!NOTE]`       | `note`      |
| `[!TIP]`        | `tip`       |
| `[!IMPORTANT]`  | `important` |
| `[!WARNING]`    | `warning`   |
| `[!CAUTION]`    | `caution`   |

:::note[パッケージが提供するコンポーネント]

zudo-doc は `Important` と `Caution` コンポーネントを登録するため、5 つのアラートバリアントはプロジェクト側でコンポーネントを登録しなくてもすべて描画されます。これらのコンポーネントは [`mdxExtras`](https://zudo-doc.takazudomodular.com/ja/docs/guides/custom-components#%E3%82%B0%E3%83%AD%E3%83%BC%E3%83%90%E3%83%AB%E7%99%BB%E9%8C%B2-mdxextras) を通じて上書きできます。

:::

## ライブデモ

以下に 5 つのバリアントすべてをライブで描画しています。

> [!NOTE]
> ユーザーが流し読みしていても知っておくべき有用な情報。

> [!TIP]
> 物事をより良く、より簡単に行うための役立つアドバイス。

> [!IMPORTANT]
> ユーザーが目的を達成するために知っておくべき重要な情報。

> [!WARNING]
> 問題を避けるためにユーザーの即時の注意が必要な緊急情報。

> [!CAUTION]
> 特定の操作のリスクや悪い結果について助言します。

## 出力されるマークアップ

出力は[アドモニションレシピ（`directives` マップ）](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/admonitions-preset)と同一です。たとえば `> [!NOTE]` は次を生成します。

```html
<div data-admonition="note" class="admonition admonition-note">
  <p class="admonition-title">…</p>
  <div class="admonition-body">…</div>
</div>
```

## メモ

- サポートされる構文は `[!TYPE]` のみです。`> [!NOTE] My Title` のように末尾にインラインタイトルを付けると、アラートではなく通常のブロック引用として扱われます。
- 複数段落がサポートされ、すべての本文がアドモニション内に収まります。
- GitHub Alerts と[アドモニションレシピ（`directives` マップ）](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/admonitions-preset)は共存します。GitHub アラートはアドモニションパスより前に処理されるため、両方を同時に有効化できます。