我们都知道如何在 Markdown 中使用反引号 `
来包裹一段代码。无论是内联的代码还是单独的代码块,都需要使用它,只是个数的差别,比如 `
和 ```
。
那么如何能够在代码片中输入反引号(backtick)呢?
方法是:用两个反引号来包裹。
内联代码中包含反引号
例如,你想输入这段代码中包含`符号
,那么你应该这么输入:
1 | ``这段代码中包含`符号`` |
---|
内联代码中只有反引号
例如,你希望输入`
,那么你应该这么输入:
1 | `` ` `` |
---|
注意,这里有 5 个 `
符号,其中前后各两个 ``
是代码块的开始和结束符,中间的 `
则是代码块中的 `
符号,代码块和内容之间必须有空格。
内联代码中只有反引号且有多个
如果你读到上面一节,你可能好奇为什么我能打出两个 ``
符号来,是因为我输入了:
1 | ``` `` ``` |
---|
注意,这里有 8 个 `
符号,其中前后各两个 ```
是代码块的开始和结束符,中间的 ``
则是代码块中的 ``
符号,代码块和内容之间必须有空格。
更多个,则以此类推。
内联代码中首尾包含反引号
有时候你希望示意 Markdown 的代码块的用法,你需要告诉别人使用 `<code>`
这样的写法。那么,你可以输入:
1 | `` `<code>` `` |
---|
由于 `
符号就在内容的开始和结尾,所以 ``
的开头和结尾也是需要输入一个空格的。
代码块中的反引号
只要代码块中的反引号数量小于三个,就能直接在代码块中使用反引号而不用担心转义问题:
1 2 | ` `` |
---|
但是,如果反引号的数量大于或等于三个,那么代码块的包裹就需要更多的反引号了:
1 2 3 4 5 | ```` 四个反引号开始的代码块 ` 有一个 `` 有两个 ``` 有三个 ```` 四个反引号结束的代码块 |
---|
反正,包括代码块的反引号可以一直重复,比里面用到的多就好了。
参考资料
- Daring Fireball: Markdown Syntax Documentation
本文会经常更新,请阅读原文: https://blog.walterlv.com/post/markdown-code-escape-backtick.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。