online - markdown tutorial

¿Cómo se escapa backticks en markdown?

Question

Estoy escribiendo alguna documentación en markdown y quiero documentar cómo crear un archivo de texto usando un HEREDOC de bash. Aquí está el comando que quiero documentar:

# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=`hostname`
> value4=onetwothree
EOT

En markdown, se usa el `para representar el texto como" código ". He intentado hacer esto ...

`# cat > /tmp/answers.txt <<EOT`
`> value1=blah`
`> value2=something else`
`> value3=/`hostname/``
`> value4=onetwothree`
`EOT`

... pero eso resulta en algo que se parece a esto ...

# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=/

nombre de host
> value4 = onetwothree
EOT

Answer 1

Creo que necesitas cambiar el "delimitador" de un solo tick de vuelta a un doble ...

es decir: ``value3=/`hostname/` ``

debe hacer

> value3=/`hostname/`

Answer 2

Este bloque de código de abajo hace el truco.

```
# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=`hostname`
> value4=onetwothree
EOT
```

Los tres Backtick significan que es un fragmento de código y un fragmento debe terminar con tres Backtick más.

Para obtener más ayuda con Markdown, consulte este CheatSheet.

Answer 3

La documentación original de la sintaxis de Markdown cubre esto ; dice que tienes que usar múltiples comillas invertidas para encerrar la expresión del código, así:

``here you go - ` this was a backtick``

hace como esto:

here you go - ` this was a backtick

Si desea incluir una marca de retroceso en el texto normal , no en un bloque de código, un escape de barra invertida hace el truco; por ejemplo esto:

Here''s a backtick: /`; then, here''s another one: /`

hace como esto:

Aquí hay un backtick: `; entonces, aquí hay otro:

( github esto en github y github y se comporta de la misma manera, así que no es solo una rareza SO)