compile プレイグラウンド
ブラウザーで zfb の MDX から ES モジュールへのコンパイルを試せます。
compile API は、zfb のブラウザーパイプラインにおけるコンパイル段階です。MDX を JSX に 変換し、その JSX を SWC に渡して、zfb がページに出力する ES モジュールのソースを返します。
この playground は docs が固定している公開済み @takazudo/zfb-md-wasm を使い、現在の zudo-react 用モジュールを出力します。
ブラウザーでコンパイルする理由
ブラウザーでのコンパイルは CMS のライブプレビューに役立ちます。編集者が入力している間も、 zfb build と同じ Rust パイプラインを使えるためです。別の Markdown 実装を使うと、実際に 公開されるページとプレビューの表示がずれる可能性があります。@takazudo/zfb-md-wasm を 使えば、ビルド時の動作に近いプレビューを作れます。
出力
実行すると ES モジュールを出力します。
初回の実行時に WebAssembly モジュールをダウンロードします。 API リファレンス
注記ディレクティブ サンプルでは、pipeline.features.directives.note = "Note" の登録を 明示しています。出力されたモジュールはホストの components map に Note を要求し、ビルドと同じ フレームワーク所有コンポーネントとの境界を確認できます。
出力されたモジュールを読む
このプレイグラウンドが表示するのはソースだけです。返されたモジュールを評価したり、訪問者が 入力した JSX をレンダリングしたりはしません。解析された frontmatter はモジュールソースと 分けて表示され、通常のコンパイルエラーや Markdown エラーは diagnostics リストに表示されます。
アプリケーションでソースを評価するには、ホスト、JSX ランタイム、components map を用意します。ブラウザー Markdown プレビューのガイドでその方法を説明します。この playground の出力は、エミッタ唯一の JSX ランタイムである @takazudo/ をインポートします。別のランタイムを選ぶ jsxRuntime オプションはありません。この指定子の解決方法はガイド、現行のオプションと結果の契約は zfb-md-wasm API リファレンスを参照してください。