最新消息:20210917 已从crifan.com换到crifan.org

【已解决】markdown中三个反印号表示代码段中如何写反印号

markdown crifan 2749浏览 0评论

在用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
也可以采用:
&lt;code&gt;&#096;&lt;/code&gt;
</code>

或:

<code>&lt;code&gt;`&lt;/code&gt;
</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}&amp;phone={phone}```
- register for new user: ```/v1.0/open/smscode?type=register&amp;phone=13811119999```
- forgot password: ```/v1.0/open/smscode?type=changePassword&amp;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中三个反印号表示代码段中如何写反印号

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
98 queries in 0.189 seconds, using 23.37MB memory