zfb の Markdown パイプラインは、常に有効な **Core（組み込み）** 機能と、`zfb.config.ts` の `markdown.features` で個別に有効化する **Opt-in（オプトイン）** 機能を提供します。

## Core 機能

以下の 7 機能は常に有効です。設定は不要です。

| 機能 | 説明 |
| --- | --- |
| [CJK Friendly](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/cjk-friendly) | 中国語・日本語・韓国語（CJK）の文章に対して、スペーシングと改行処理を改善します。 |
| [Heading Links](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/heading-links) | h2 以上の見出しにアンカーリンクを追加し、ページ内の直接リンクを可能にします。 |
| [Code Title](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/code-title) | コードブロックに `title="…"` を設定すると、ファイル名や見出しバーを表示します。 |
| [Resolve Links](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/resolve-links) | 相対パスの `.mdx`/`.md` リンクをクリーンなドキュメント URL に解決します。 |
| [Strip .md Extension](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/strip-md-ext) | 出力される内部リンクの href から `.md`/`.mdx` 拡張子を除去します。 |
| [Syntax Highlighting](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/syntax-highlighting) | アクティブなカラースキームに対応するビルド時セマンティッククラスハイライト。 |
| [Directives Registry](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/directives-registry) | 汎用的な `:::name` ディレクティブエンジン — ディレクティブ構文を JSX コンポーネントにマッピングします。アドモニションのボキャブラリはレシピとして別途登録されます。 |

## Opt-in 機能

以下の 14 機能は zfb エンジンレベルでは opt-in（オプトイン）です — 明示的に設定しない限り無効で、多くは `markdown.features.*` 配下のキーで設定します（External Links と Image Enlarge は別の形のキーを使います）。ただし、このショーケース自体は `markdown` を直接設定していません。`zudoDoc({...})` プリセットが下表の `markdown.features.*` エントリの大半をあらかじめ有効化しています — プリセットの正確なデフォルト値は各機能のページを参照してください。素の `defineConfig({ markdown: { features: {...} } })` は `zudoDoc()` を完全にバイパスし、プリセットが配線する残りすべて（コレクション、Chrome、コードハイライトなど）を失わせるため、常に `zudoDoc({...})` から始めてその `markdown` ブロックを拡張してください。

| 機能 | 設定キー | 説明 |
| --- | --- | --- |
| [External Links](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/external-links) | `markdown.externalLinks` | 有効化すると外部リンクに `target`/`rel` を付与します。デフォルトでは無効 — 有効/無効にかかわらず、本文中のリンクに自動的な視覚インジケーターは付与されません。 |
| [Admonitions Preset](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/admonitions-preset) | `directives` | `directives` マップでアドモニションのボキャブラリ（note/tip/warning/danger/info/caution/details）を登録します。 |
| [Mermaid](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/mermaid) | `mermaid` | ` ```mermaid ` フェンスをクライアントサイドの Mermaid ライブラリで図として描画します。 |
| [Image Enlarge](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/image-enlarge) | `settings.imageEnlarge` | クリックで拡大できる `<figure>` に画像をラップします。ユーザーランド設定 — 組み込みの `markdown.features` キーは next.18 で削除されました。 |
| [Heading Marker TOC](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/heading-marker-toc) | `headingMarkerToc` | 各見出しにアンカーマーカーを付与し、TOC アイランドにデータを提供します。 |
| [GitHub Alerts](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/github-alerts) | `githubAlerts` | `> [!NOTE]`/`[!TIP]`/`[!WARNING]`/`[!IMPORTANT]`/`[!CAUTION]` ブロック引用をアドモニションマークアップに変換します。 |
| [Reading Time](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/reading-time) | `readingTime` | 推定読了時間を計算し、ページレベルのメタデータとして公開します。 |
| [Code Enrichment](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/code-enrichment) | `codeEnrichment` | ハイライト済みのコードブロックに diff/行/単語ハイライト装飾を追加します。タイトルバーは別の常時有効な Core 機能です（[Code Title](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/code-title) 参照）。コピー/折り返しボタンは、この機能の有効・無効にかかわらず、すべてのコードブロックに追加されます。 |
| [Code Tabs](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/code-tabs) | `codeTabs` | `:::code-group` ディレクティブを `<CodeGroup>` 経由でタブ付きコードパネルとして描画します。 |
| [Ruby](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/ruby) | `ruby` | ルビ注釈サポートを追加します（`{base}^{ruby}` 構文）。 |
| [TOC Export](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/toc-export) | `tocExport` | ページの目次を `export const toc` 名前付きエクスポートとして出力します。 |
| [Image Dimensions](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/image-dimensions) | `imageDimensions` | ビルド時にディスクのメタデータから画像に `width`/`height` 属性を付与します。 |
| [Link Validation](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/link-validation) | `linkValidation` | ビルド時に内部リンクを検証し、壊れた参照に警告（またはエラー）を出します。 |
| [Transclude](https://zudo-doc.takazudomodular.com/ja/docs/markdown-features/transclude) | `transclude` | 別の Markdown / MDX ファイルをソース AST へ差し込みます。デフォルトでは無効で、`zudoDoc({ transclude: true })` により有効化します。 |

:::note[その他のパイプライン設定]

zfb にはトップレベルの `markdown` 設定として `markdown.gfm`（GitHub Flavored Markdown の各構文をきめ細かく切り替える）と `markdown.hardBreaks`（ソフト改行をすべて `<br>` に変換する）も存在します。どちらも上記の Core/Opt-in の一覧には含まれていません。`markdown.hardBreaks` はこのプロジェクトの `zfb.config.ts` で設定されていませんが、`zudoDoc({...})` プリセットはデフォルトで `markdown.gfm: { taskListItem: true, footnoteDefinition: true }` を設定しているため、GFM のタスクリストとフットノートは `[ ]` / `[^1]` というリテラルなテキストではなく実際にレンダリングされます。

:::