Fuga dalle doppie parentesi graffe all'interno di un blocco di codice markdown in Jekyll

Sto usando Jekyll per creare un sito di documentazione in cui cerco di documentare del codice che contenga la sintassi simile a un manubrio. Ad esempio {{foo}}. Il problema è che Jekyll utilizza tag liquidi e non importa quello che faccio, i miei doppi ricci vengono strappati dal processore liquido.

A proposito, sto usando kramdown come processore di markdown.

Ecco qualcosa che ho provato:

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

Questo rimuove completamente la sezione {{name}} perché pensa che sia un riferimento a una variabile liquida.

Ho provato anche questo:

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

In questo caso, sto cercando di evitare le parentesi graffe, ma il risultato è che le barre vengono visualizzate nella pagina.

Ho anche provato questo:

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

Certo, questo era piuttosto stupido. In questo caso, poiché ho specificato la sintassi come html (che deve essere), il tag span viene visualizzato nella pagina.

Allora come nel mondo posso risolverlo?

Stai cercando il {% raw %}tag.

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

Puoi utilizzare {% raw %}per assicurarti che il contenuto non venga modificato da Jekyll:

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

Tuttavia, tieni presente che questo non è un blocco di codice . Avrai bisogno di una formattazione del codice aggiuntiva per rendere il contenuto visualizzato come codice:

{% 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 %}

Con jekyll il codice è:

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

Per riferimenti futuri: utilizzare plain {% raw %}ed {% endraw %}è solo la seconda migliore soluzione poiché vengono mostrati se si cerca il Markdown sul normale github.com.

Il modo migliore è inserire {% raw %}e {% endraw %}nei commenti HTML:

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

A causa dei commenti HTML, viene visto da Github come un commento. Nelle pagine Github i tag grezzi impediranno l'analisi delle parentesi graffe tra i tag.

Funziona in jekyll :

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