MarkDown 语法
GitBook 默认使用MarkDown语法。MarkDown是一种轻量级标记语言,语法简洁,让作者更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与 HTML 混编,可导出 HTML、PDF 以及.md格式的文件。Github、Wikipedia 等网站都有使用MarkDown文本。
1. 标题和段落
1.1. 标题
markdown支持6级标题,每一级标题根据#号个数确定,以#号开头。
| 级别 | markdown形式 | html形式 |
|---|---|---|
| 一级标题 | # 标题 |
<h1>标题</h1> |
| 二级标题 | ## 标题 |
<h2>标题</h2> |
| 三级标题 | ### 标题 |
<h3>标题</h3> |
| 四级标题 | #### 标题 |
<h4>标题</h4> |
| 五级标题 | ##### 标题 |
<h5>标题</h5> |
| 六级标题 | ###### 标题 |
<h6>标题</h6> |
1.2. 段落
markdown以空行作为段落的分段标志。
第一段
第二段
2. 强调
强调文本包括文本加粗、斜体等。
2.1. 粗体
单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)可实现文本加粗,例如“加粗”就是由“**加粗**”实现,“加粗”就是由“__加粗__”实现。这些都是MarkDown的语法,在HTML中,可以用标签“<strong></strong>”实现。
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | **加粗** 或 __加粗__ |
加粗 或 加粗 |
| HTML语法 | <strong>加粗</strong> |
加粗 |
MarkDown和HTML两种语法,GitBook都能认识。
2.2. 斜体
用星号*或下划线_可以设计斜体。
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | *斜体* 或 _斜体_ |
斜体 或 斜体 |
| HTML语法 | <em>斜体</em>或 <i>斜体</i> |
斜体 或 斜体 |
2.3. 斜体+粗体
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | ***斜体+粗体*** 或 ___斜体___ |
斜体+粗体 或 斜体 |
| HTML语法 | <strong><em>斜体</em></strong>或 <strong><i>斜体</i></strong> |
斜体 或 斜体 |
2.4. 删除线
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | ~~删除线~~ |
|
| HTML语法 | <s>斜体</s> |
3. 表格
MarkDown 的表格设置语法比较简单,例如下面的表格及其代码。
| 第一列 | 第二列 | 第三列 | 第四列 |
|---|---|---|---|
| 第二行 | 第二行 | 第二行 | 第二行 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |
| 第一列 | 第二列 | 第三列 | 第四列 |
| ---- | ---- | ---- | ---- |
| 第二行 | 第二行 | 第二行 | 第二行 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |
|、-、:之间的多余空格会被忽略,不影响布局。默认标题栏居中对齐,内容居左对齐。
-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。内容和
|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少一个。
| 第一列 | 第二列 | 第三列 | 第四列 |
|---|---|---|---|
| 第二行第一列 | 第二行第二列 | 第二行第三列 | 第二行第四列 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |
| 第一列 | 第二列 | 第三列 | 第四列 |
| ---: | :--- | ---- | ---- |
| 第二行第一列 | 第二行第二列 | 第二行第三列 | 第二行第四列 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |
4. 列表
Gitbook可以建立两种列表,分别是有序列表和无序列表。
4.1. 有序列表
有序列表以数字 1. 起始,每个列表项以数字加英文句点开始,数字不必按顺序排列。
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | 1. 第一项 3. 第二项 5. 第三项 |
1. 第一项 3. 第二项 5. 第三项 |
| HTML语法 | <ol><li>第一项</li><li>第二项</li><li>第三项</li></ol> |
|
[!NOTE] 在表格中,如果需要用到列表,每一项的后面需要添加换行符
<br>使之能够换行,形成列表项。在正常文本中,是不需要换行符的,只需要正常空行就行。
4.2. 无序列表
无序列表以破折号 (-)、星号 (*) 或加号 (+)开头,一个或多个缩进,可形成嵌套列表。
| 类别 | 代码 | 效果 |
|---|---|---|
| MarkDown语法 | - 第一项 - 第二项 - 第三项 |
- 第一项 - 第二项 - 第三项 |
| HTML语法 | <ul><li>第一项</li><li>第二项</li><li>第三项</li></ul> |
|
[!NOTE] 在表格中,如果需要用到列表,每一项的后面需要添加换行符
<br>使之能够换行,形成列表项。在正常文本中,是不需要换行符的,只需要正常空行就行。
5. 公式
\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N