比較の観点
GFM 互換性(Alerts)
一般的な GitHub Flavored Markdown は使えますが、GitHub Alert マーカーには別の統合または Callout が必要です。
結果
Fumadocs MDX は表、打ち消し線、自動リンク、タスクリストなどの
一般的な GFM 記法を扱えます。GitHub Alerts は GFM 仕様の外にある
GitHub 固有の拡張で、この基本構成では [!NOTE] が通常の引用内に残ります。
実動 GFM 要素
| 記法 | 表示結果 |
|---|---|
| 打ち消し | |
| 自動リンク | https://www.fumadocs.dev/ |
| インラインコード | bun run build |
- 静的ルートを生成
- 日英の原稿を作成
- 自動翻訳
次はソースに書いた GitHub Alert 形式そのものです。
[!NOTE] 内容は読めますが、この基本構成はマーカーを GitHub 風の色付き Alert に変換しません。
UI の標準的な代替
Fumadocs Callout
Fumadocs UI には MDX 用の Callout があります。GitHub Alert 記法を 標準対応と誤認させず、装飾された通知を提供できます。