在用Gitbook期间,写markdown时,遇到个问题:
希望在三个反印号
<code>的代码段中,xxx中包含反印号。 此处去网上搜了下,用反斜杠加上反印号: 结果是可以不被误识别为代码段了,但是显示效果中却还出现反印号: 不是我要的。 markdown backtick in code How can the backtick character ` be included in code? - Meta Stack Exchange 代码中的反印号,用空格隔开 就行了? 去试试 结果: 可以正常包含,但还是出现不需要的空格啊 难道最外部用4个反印号,内部连续3个反印号,就不会被解析为代码了? 结果: 达到我要的效果了: 另外: How can the backtick character ` be included in code? - Meta Stack Exchange 也可以采用: <code>`</code> </code>
或:
<code><code>`</code> </code>
Daring Fireball: Markdown Syntax Documentation
【总结】
背景:
markdown中,对于反印号内部,表示代码段。
一般起始和末尾 用单个反印号 就可以了,叫做内联代码,比如:
<code>`your code` </code>
而经常要写连续的多行代码,则一般用2个或3个反印号开始和结束:
<code>```codeLanguage code line 1 code line 2 ... ``` </code>
需求:
而代码段中如果要包含3个连续的反印号,则可以:
把最外层的表示代码段的3个反印号,变成4个反印号,内部3个反印号就可以当作普通代码,不会被误解析为代码段了:
<code>````markdown # API接口 ## 注册 ### 获取验证码 目前有4种短信验证码,对应的type是: - 注册短信验证码: register - 修改密码短信验证码: changePassword - 修改手机短信验证码: changePhoneNumber - 验证手机号短信验证码: verifyPhoneNumber #### Request - Method: **GET** - URL: ```/v1.0/open/smscode?type={type}&phone={phone}``` - register for new user: ```/v1.0/open/smscode?type=register&phone=13811119999``` - forgot password: ```/v1.0/open/smscode?type=changePassword&phone=13822224444``` - Headers: - Body: ``` ``` #### Response - Body ``` { "code": 200, "data": "730781", "message": "OK" } ``` 注意:为了防止短信验证码被滥用,短信如果发送后,需要隔60s才能重新发送。 ```` </code>
效果:
注:
根据帖子介绍的语法,其实反印号的逻辑是:
最外层表示代码段的起始和开始,前后的反印号个数一致即可。
而代码段内部只要反印号个数和最外层不一样,就可以了。
比如:
<code> ` 最外层是1个反印号 内部可以包含 2个反印号`` 3个反印号``` 4个反印号``` ` `` 最外层是2个反印号 内部可以包含 1个反印号` 3个反印号``` 4个反印号``` `` ``` 最外层是3个反印号 内部可以包含 1个反印号` 2个反印号`` 4个反印号``` ``` </code>
但是此处经过测试,好像不行:
效果:
所以还是按照上面的逻辑:
最外层的反印号个数,比代码段中最多的连续的反印号个数更大,就可以了。
比如:
效果正常:
最后,抽空多看看最权威的markdown的语法:
Daring Fireball: Markdown Syntax Documentation
转载请注明:在路上 » 【已解决】markdown中三个反印号表示代码段中如何写反印号