Экранирование двойных фигурных скобок внутри блока кода уценки в Jekyll

Я использую Jekyll для создания сайта документации, на котором я пытаюсь задокументировать некоторый код, который содержит синтаксис, подобный ручке. Например {{foo}}. Проблема в том, что Jekyll использует жидкие метки, и что бы я ни делал, мои двойные завитки вырываются жидким процессором.

Кстати, в качестве процессора уценки я использую 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 %}

С Джекиллом код:

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

Для справок в будущем: использование plain {% raw %}и {% endraw %}является вторым лучшим решением, поскольку они показаны, если вы посмотрите Markdown на обычном github.com.

Лучше всего добавить {% raw %}и {% endraw %}в HTML-комментарии:

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

Из-за комментариев HTML он рассматривается Github как комментарий. На страницах Github необработанные теги предотвратят анализ фигурных скобок между тегами.

Это работает в jekyll :

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