45

私はいくつかのドキュメントを書いており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
EOT

4

3 に答える 3

60

元の Markdown 構文ドキュメントはこれをカバーしています。コード式を括弧で囲むには、複数のバッククォートを使用する必要があると書かれているので、次のようにします。

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

次のようにレンダリングします。

here you go - ` this was a backtick

コード ブロックではなく、通常のテキストにバッククォートを含めたい場合は、バックスラッシュ エスケープを使用するとうまくいきます。たとえば、これ：

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

次のようにレンダリングします。

ここにバッククォートがあります: `; それから、ここに別のものがあります: `

(私はこれをcommonmarkとgithubでテストしましたが、同じように動作するので、単なるスタック オーバーフローの奇妙さではありません)

于 2014-09-19T22:07:41.103 に答える
12

以下のコードブロックはそのトリックを行います。

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

3 つのバックティックはコードのスニペットであることを意味し、スニペットはさらに 3 つのバックティックで終了する必要があります。

Markdown の詳細については、このCheatSheet を参照してください。

于 2015-01-04T08:42:28.883 に答える
9

「区切り文字」を単一のバックティックから二重に変更する必要があると思います...

すなわち: ``value3=\`hostname\` ``

レンダリングする必要があります

> value3=\`hostname\`

于 2014-06-19T17:57:21.927 に答える