Я пишу некоторую документацию в 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
СРВ
Этот кодовый блок ниже выполняет трюк.
```
# cat > /tmp/answers.txt <<EOT
> value1=blah
> value2=something else
> value3=`hostname`
> value4=onetwothree
EOT
```
Три Backtick означают, что это фрагмент кода, а фрагмент должен заканчиваться еще тремя Backtick.
Для получения дополнительной информации о Markdown см. этот CheatSheet.
Исходная документация синтаксиса 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-странность)
Я думаю, вам нужно изменить "разделитель" с одного обратного тика на двойной...
т.е.:
``value3=\`hostname\` ``
должен отображать
> value3=\`hostname\`