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 的表格设置语法比较简单,例如下面的表格及其代码。

第一列 第二列 第三列 第四列
第二行 第二行 第二行 第二行
第三行 第三行 第三行 第三行
第四行 第四行 第四行 第四行
| 第一列 | 第二列 | 第三列 | 第四列 |
| ----  | ---- | ---- | ---- |
| 第二行 | 第二行 | 第二行 | 第二行 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |
  1. |-:之间的多余空格会被忽略,不影响布局。

  2. 默认标题栏居中对齐,内容居左对齐。

  3. -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。

  4. 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少一个。

第一列 第二列 第三列 第四列
第二行第一列 第二行第二列 第二行第三列 第二行第四列
第三行 第三行 第三行 第三行
第四行 第四行 第四行 第四行
| 第一列 | 第二列 | 第三列 | 第四列 |
| ---:  | :--- | ---- | ---- |
| 第二行第一列 | 第二行第二列 | 第二行第三列 | 第二行第四列 |
| 第三行 | 第三行 | 第三行 | 第三行 |
| 第四行 | 第四行 | 第四行 | 第四行 |

4. 列表

Gitbook可以建立两种列表,分别是有序列表和无序列表。

4.1. 有序列表

有序列表以数字 1. 起始,每个列表项以数字加英文句点开始,数字不必按顺序排列。

类别 代码 效果
MarkDown语法 1. 第一项 3. 第二项 5. 第三项 1. 第一项
3. 第二项
5. 第三项
HTML语法 <ol><li>第一项</li><li>第二项</li><li>第三项</li></ol>
  1. 第一项

  2. 第二项

  3. 第三项

[!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

Γ(n)=(n1)!nN\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N

© phdlisl all right reserved,powered by GitbookUpdate in 2025-10-10

results matching ""

    No results matching ""