Markdown的基础语法

Markdown介绍

Markdown是一种轻量级标记语言，文件名的末尾是md，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。

Markdown的标题与段落语法

标题

要创建标题，请在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。Markdown的基础语法支持到六级标题。
还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 – 号来标识二级标题。

ps.当需要在使用# 这个字符时需再# 后加空格以加区分。

段落

使用空白行将一行或多行文本进行分隔以创建新的段落。
在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行。

Markdown的强调语法

加粗

要加粗文本，在单词或短语的前后各添加两个星号（ * ）或下划线（ _ ）。
如需加粗一个单词或短语的中间部分用以表示强调的话，在要加粗部分的两侧各添加两个星号（ * ）。

效果：加粗的文本

斜体

要斜体文本，在单词或短语的前后各添加一个星号（ * ）或下划线（ _ ）。
如需斜体一个单词或短语的中间部分用以表示强调的话，在要斜体部分的两侧各添加一个星号（ * ）。

效果：斜体的文本

加粗并斜体

要加粗并斜体文本，在单词或短语的前后各添加三个星号（ * ）或下划线（ _ ）。
如需加粗并斜体三个单词或短语的中间部分用以表示强调的话，在要加粗并斜体部分的两侧各添加三个星号（ * ）。

效果：加粗并斜体的文本

Markdown的引用与代码语法

引用

要创建块引用，在段落前添加一个（>）符号。
块引用支持多段落，为段落之前的空白行加上一个（>）符号。
块引用支持一些带有其他Markdown的元素的引用，但并不支持所有的Markdown元素。
引用效果会对整段文本生效。

效果：

被引用的第一段

被引用的第二段
加粗并斜体的引用文本

加点的引用文本

双重引用

代码

要将单词或短语表示为代码，将其包裹在反引号（`）中。
若引用的代码中带有反引号，则需要将其包裹在用两个反引号中。
代码块则需要空出一行空白行并在代码块开头添加四个空格或一个制表符，或在代码块之前和之后的行上使用三个反引号（```）或三个波浪号（~~~）。
代码块的语法支持突出显示。可以为编写代码的任何语言添加颜色突出显示。要添加语法突出显示，在受防护的代码块之前的反引号旁边指定一种语言。

效果：main()

//注释
main(){
    //代码
    return 0;
}

Markdown的列表语法

有序列表

创建有序列表，在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表需以数字 1 起始。
要在保留列表连续性的同时在列表中添加另一种元素，将该元素缩进四个空格或一个制表符。

效果：

有序列表1
有序列表2
1. 嵌套有序列表1
```
  main(){

  }
```
2. 嵌套有序列表2
有序列表3

无序列表

创建无序列表，在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

效果：

无序列表

Markdown的连接语法

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。
超链接Markdown语法代码：[超链接显示名](超链接地址 "超链接title") 。

效果：海瑶的个人博客

Markdown的图片语法

要添加图像，使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码：![图片alt](图片链接 "图片title")。

效果：

Markdown的表格语法

添加表，使用三个或多个连字符（—）创建每列的标题，并使用管道（|）分隔每列。可以选择在表的任一端添加管道。

| 标题1       | 标题2        |
| ----------- | ----------- |
| 1-1         | 1-2         |
| 2-1         | 2-2         |

可以通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心。



| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

效果：

标题1	标题2
1-1	1-2
2-1	2-2

Syntax	Description	Test Text
Header	Title	Here’s this
Paragraph	Text	And more

Markdown其他语法

删除线

单词前后分别加上两个波浪号~~。

效果：~~被划掉惹~~

分隔线

在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容，以创建分隔线。

效果：

上面是分隔线

表情

以冒号开头和结尾，并包含表情符号的名称。
可以通过表情符号简码列表来查询表情简码。

1 2	兔兔这么可爱 :rabbit2:，但非常的美味 :yum:。

效果：
兔兔这么可爱 :rabbit2:，
但非常的美味 :yum:。

参考资料

markdown基础语法文档
 markdown扩展语法文档
 表情符号简码列表

Markdown基础语法