CJK フレンドリーな強調

CJK の表意文字やかなに隣接する太字・斜体マーカーが正しく解釈されるようにする。

CjkFriendlyPlugin はデフォルトで有効です。パース済みの Markdown AST を後処理し、CJK コンテンツに対して強調のフランキング規則を再トークン化します。同じ cjkFriendly ゲートは、GFM の bare URL autolink が隣接する CJK テキストを飲み込むことを防ぐ CjkAutolinkBoundaryPlugin も制御します。

なぜこれが必要か

CommonMark の強調フランキング規則は、CJK の表意文字やかなを 「非空白かつ非句読点」として扱います。これにより、CJK テキストに隣接する ** — たとえば **テスト。**テスト — は基本パーサーでは右フランキングとみなされず、 <strong> ではなくそのままのアスタリスクとして描画されてしまいます。

CjkFriendlyPlugin はパース済みの Markdown AST を後処理し、これらのケースを 再トークン化します。その結果は、日本語・中国語・韓国語のコンテンツサイトにおける 直感的な期待と一致します。

GFM autolink literal には関連する境界問題があります。詳細はhttps://example.com参照 のように CJK テキストに密着して URL を書くと、末尾の CJK の並びがリンクの一部として扱われることがあります。cjkFriendly が有効で、gfm.autolinkLiteral が on のとき、CjkAutolinkBoundaryPlugin は最初に隣接する CJK 文字の位置で autolink を分割します。

挙動

デフォルト: 常に有効。設定キーは不要です。

オプトアウト（まれ）: 厳密な CommonMark / GFM 出力が必要で、かつコンテンツに CJK の強調や bare URL の境界ケースが含まれない場合に限り、zfb.config.ts で cjkFriendly: false を 設定します:

import { defineConfig } from "zfb/config";

export default defineConfig({
  markdown: {
    cjkFriendly: false,
  },
});

スコープ

このオプションは次を処理します:

• CJK 文字に隣接する **bold** と *italic*。

• gfm.autolinkLiteral が有効なときの、CJK 文字に隣接する GFM bare URL autolink 境界。

• セカンダリパースサイトを経由するコンテンツ — :::include で取り込まれたファイルや、 ディレクティブレジストリによって再パースされるディレクティブ本体 — も、この設定に 従うようになりました（#2398）。

リテラルの * と ** の修復は、対応するパース済みインライン兄弟ノードをまたぐことができ、それらのノードはそのまま保持されます。たとえば:

知られる**[LA-2A](https://example.com)光学式コンプレッサー**と、**Neve 1073 EQ**という

最初の strong 範囲には保持された LA-2A リンクと 光学式コンプレッサー が含まれ、既存の続く strong 範囲には Neve 1073 EQ が含まれます。未対応または不透明なインラインコンテンツは境界のままです。

GFM の打ち消し線（~~foo~~）にはこのトグルは不要です — markdown-rs の GFM トークナイザーが ~~ のデリミタ連続を独立して処理するため、両方のモードで CJK の境界においても打ち消し線は正しく機能します。

HTML レンダリングパスにおけるディレクティブ本体の強調

cjkFriendly はマーカーを正しく再トークン化し、 @takazudo/zfb-md-wasm の renderHtml はコンテナ ディレクティブの子要素を通常の HTML パスで描画します。そのため、未解決の カスタムコンポーネントタグ内でもインライン書式とブロック境界が保持されます。 次のソースは:

:::note
これは**重要。**テスト
:::

このように描画されます:

<Note><p>これは<strong>重要。</strong>テスト</p></Note>

これは cjkFriendly に固有の挙動ではなく、collapsed（空行なし）のディレクティブ 本体に固有の挙動でもありません。cjkFriendly が off の ASCII でも、 plain **bold** text を :::note で囲むとネストした <strong> が保持されます。 本体の前後に空行を入れた場合も、対応する <p> 境界が保持されます。 cjkFriendly が決めるのは、CJK に隣接する ** が強調としてトークン化されるか どうかだけです。cjkFriendly: false では、そのマーカーはリテラルの ** のまま 残ります。

zfb build は別の MDX/JSX エミッターを使い、コンポーネント JSX として同じ書式を 保持します。hardBreaks が有効な場合、ディレクティブ本体内の ハードブレークは通常の HTML シリアライザー形式である <br/> として描画されます。

関連項目

• Markdown のカスタマイズ — パイプライン全体の概要。