Как избежать уклонов от уклона?

Я пишу некоторую документацию в markdown и хочу документировать, как создать текстовый файл с помощью bash HEREDOC. Вот команда, которую я хочу документировать:

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

В методе уценки используется `для отображения текста как "кода", я попытался сделать это...

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

... но это приводит к тому, что выглядит так...

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

имя хоста
> value4 = onetwothree
СРВ

Ответ 1

Этот кодовый блок ниже выполняет трюк.

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

Три Backtick означают, что это фрагмент кода, а фрагмент должен заканчиваться еще тремя Backtick.

Для получения дополнительной информации о Markdown см. этот CheatSheet.

Ответ 2

Исходная документация синтаксиса Markdown охватывает это; он говорит, что вам нужно использовать несколько backticks для скобки выражения кода, так вот так:

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

делает следующее:

here you go - ` this was a backtick

Если вы хотите включить обратный ход в обычный текст, а не в блок кода, побег с обратной косой чертой делает трюк; например:

Here a backtick: \`; then, here another one: \`

делает следующее:

Здесь backtick: `; то вот еще один: `

(я тестировал это на commonmark и github, и он ведет себя так же, как и а не просто SO-странность)

Ответ 3

Я думаю, вам нужно изменить "разделитель" с одного обратного тика на двойной...

т.е.: ``value3=\`hostname\` ``

должен отображать

> value3=\`hostname\`