基本语法
换行与段落
要换行,请在上一行的行尾加上一个换行标签<br>
。
例如
这样,<br>或是这样<br>
会换行<br>
但是这样
并不会换行
这样,
或是这样
会换行
但是这样
并不会换行
要创建段落,请将两个段落间使用一个空行分隔
例如
一个段落
另一个段落
其效果为
一个段落
另一个段落
斜体与粗体
如要使用斜体,请在文本前后各加上一个星号*
或是一个下划线_
,出于兼容性的考虑,我们推荐使用*
。
例如
*斜体*的英文是 _Italic_
其效果为:
斜体的英文是 Italic
如要使用粗体,请在文本前后各加上一个星号**
或是一个下划线__
,出于兼容性的考虑,我们推荐使用**
。
例如
**粗体**的英文是 __Bold__
其效果为:
粗体的英文是 Bold
粗体与斜体可以相互嵌套
例如
***粗斜体***
,**粗体*与*斜体**
,*斜体 __与__ 粗体*
其效果分别如下
粗斜体,粗体与斜体,斜体 与 粗体
标题
在标题前方加入一定数量的井号#
以实现特定级别的标题,井号与标题中间应有一个空格作为分隔,且标题与正文间有一个空行作为分隔。最多支持六级标题
例如
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 七级标题?
特别地,对于一级标题与二级标题,存在另一种表现形式,在一行文字下方加入一行大于等于三个的等号===
可以构成一级标题;在一行文字下方加入一行大于等于三个的减号---
可以构成二级标题;
例如
一级标题
===
---
二级标题
超链接与图片
要使用超链接,请使用一对方括号[]
括住需要插入超链接的文字,并在其后加一对小括号()
,小括号中为需要插入的超链接。
例如
[超链接](https://www.bilibili.com/video/av308040/)
其效果为:
要使用图片,请使用一对方括号[]
括住图片的标题,并在方括号前加一个感叹号!
,在方括号后加一对小括号()
,小括号中为图片的路径或地址。
例如

其效果为
引用
要使用引用,请在要引用的段落前加入一个大于号>
,并使用空格与要引用的段落间隔开,引用内容也应与正文部分使用一个空行间隔开。
例如
> 这是引用
> 这是另一个引用
>
> 这是连续的两段引用
>> 这是嵌套引用
其效果为
这是引用
这是另一个引用
这是连续的两段引用
这是嵌套引用
列表
有序列表
创建有序列表,请参考如下示例,序号与列表内容间应以一个空格分隔
1. 第一项
2. 第二项第一段落
第二项第二段落
1. 第一子项
2. 第二子项
3. 第三项
其效果为
- 第一项
- 第二项第一段落
第二项第二段落
1. 第一子项
2. 第二子项
- 第三项
无序列表
要创建无序列表,只需将有序列表中的序号换为加号+
、减号-
或星号*
当中的一个,请在同一个无序列表中使用相同的符号。
处于统一格式的角度,本手册推荐您使用减号-
- 项
- 项
- 子项
- 子项
- 项
其效果为
- 项
- 项
- 子项
- 子项
- 项
有序列表可以和无序列表相互嵌套。
行内代码
如果要在行内使用代码格式,请使用一对反引号``
将代码括起来
例如请输出`hello, world`语句
的效果为:请输出hello, world
语句
如果代码中包含反引号,请使用一对两个反引号。
分割线
要创建分割线,请在单独的一行上使用大于等于三个的星号***
、减号---
或是下划线___
,并在前后各加一个空行与上下文分隔开,效果如下:
转义字符
要显示一个原本用于格式化 Markdown 文档中的文本的文本字符,请在字符前面添加一个反斜杠\
。
例如这不是\*粗体\*
的效果为: 这不是*粗体*