Jekyllのマークダウンコードブロック内の二重中括弧のエスケープ

Jekyllを使用して、ハンドルバーのような構文を含むコードをドキュメント化しようとしているドキュメントサイトを作成しています。たとえば{{foo}}。問題は、ジキルが液体タグを使用していて、私が何をしても、私のダブルカーリーが液体プロセッサーによって引き裂かれていることです。

ちなみに、私はマークダウンプロセッサとしてkramdownを使用しています。

これが私が試したものです：

{% highlight html linenos %}
  Hello, my name is {{name}}.
{% endhighlight %}

これは、液体変数への参照であると見なすため、{{name}}セクションを完全に削除します。

私もこれを試しました：

{% highlight html linenos %}
  Hello, my name is \{\{name\}\}.
{% endhighlight %}

この場合、中括弧をエスケープしようとしていますが、結果としてスラッシュがページにレンダリングされます。

私もこれを試しました：

{% highlight html linenos %}
  Hello, my name is <span>{</span>{name}}.
{% endhighlight %}

確かにこれはかなり馬鹿だった。この場合、構文をhtml（必要）として指定したため、spanタグがページにレンダリングされます。

では、世界でこれをどのように解決できますか？

あなたは{% raw %}タグを探しています。

{% raw %}
Hello, my name is {{name}}.
{% endraw %}

{% raw %}Jekyllによってコンテンツが変更されていないことを確認するために使用できます。

{% raw %}
This is inserted literally: {{foo}}
{% endraw %}

ただし、これはコードブロックではないことに注意してください。コンテンツをコードとしてレンダリングするには、追加のコードフォーマットが必要になります。

{% raw %}
    I'm a code block, because I'm indented by 4 spaces
{% endraw %}

{% raw %}
```handlebars
I'm a code block that contains {{handlebars}}
with highlighting.
```
{% endraw %}

jekyllの場合、コードは次のとおりです。

{% highlight html%}
{% raw %}
     <h2> {{ user.name.first | uppercase }}</h2>
     <p> {{ user.email }}</p>
{% endraw %}
{% endhighlight %}

今後の参考のために：通常のgithub.comでMarkdownを検索すると表示されるため、プレーン{% raw %}を使用{% endraw %}することは2番目に良い解決策にすぎません。

最良の方法は置くことです{% raw %}し、{% endraw %}HTMLのコメントで：

<!-- {% raw %} -->
something with curlky brackets like { this } and { that }
<!-- {% endraw %} -->

HTMLコメントのため、Githubではコメントと見なされます。Githubページでは、rawタグにより、タグ間の中括弧の解析が防止されます。

これはjekyllで機能します：

{%raw%}{{thing}}{%endraw%}