hyogen ブロック

hyogen-md の制御構文は HTML コメント内に書きます。Markdown プレビューでは表示されません。

通常形: @hg … @endhg

<!--
@hg
include ./components/description.md
@endhg
-->

@hg / @endhg と等価です。短く書けます。

<!--@@
include ./components/description.md
@@-->

改行あり・同一行・minify 相当のいずれでも認識します。

<!--@hg
const title = "Hello"
@endhg-->

<!--@hg /* ブロックコメントなら同一行でも OK */ @endhg-->

<!--@@ /* ワンライナー */ @@-->

同一行にまとめる場合、// 行コメントは行末までがコメントになるため使えません。その場合は /* */ を使ってください。

@hg 内では JavaScript と同様のコメントが使えます。

<!--
@hg

// 行コメント

/* ブロックコメント */

@endhg
-->

コードフェンス（```）内の hyogen ブロックは無視されます。生テキストとして扱い、実行・展開しません。

デフォルトでは、レンダリング後の Markdown から hyogen コメントは除去されます。デバッグ用に残す場合は preserveHgComments: true を指定します。

領域	内容
hyogen ブロック内	宣言・代入・`include`・`if` / `each` の構造ディレクティブなど
`{{ }}` 内	式のみ