Markdown学习文档

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

1.标题语法

# heading level ：井号的个数表明了标题的等级，个数越多等级就越低。通常在井号和标题之间用空格隔开。同时也可以在文本后边用任意数量的=来表明一级标题，用任意数量的-表明二级标题。

 

2.段落语法

若要创建段落，使用空白行对两段文字进行分割。同时无需使用tab和添加空格来缩进文本，md会自动完成该操作。

 3.换行语法

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行。因为空格难以被人眼很快识别到，因此md还提供HTML的<br>标签换行。

 4.强调语法

通过将文本设置为粗体或者斜体来强调其重要性。

粗体：在文本的前后各添加两个星号或者下划线。如果要加粗一个单词中间的某个部分，则需要在该部分左右两侧加星号或者下划线，但是不需要加空格。

 斜体：在文本前后各自添加一个星号或者下划线。斜体一个单词的中间部分操作同粗体。

 若需同时对某个文本加粗和斜体，则需要在文本前后加三个星号或者下划线。

5.引用语法

若需创作块引用，需要在段落前添加一个>符号。若需对多个段落创建块引用，那么段落之间的空白行也需要添加该符号。

> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

 若要对块引用进行嵌套，则需要在引用内再次添加>符号。

> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

 同时也可以带有md格式的其他元素。

> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.

效果如下：

The quarterly results look great!

• Revenue was off the chart.
• Profits were higher than ever.

Everything is going according to plan.

 6.列表语法

将多个条目组织成有序或者无序的列表。

有序列表：在每个列表项前添加数字并紧跟一个英文句点。数字不必按照数学顺序排列，但是列表应当以数字1起始。

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

 如果需要在列表中嵌套其他元素，需要将该元素缩进四个空格或者一个制表符，同时也可以在列表中嵌套引用>。但是在嵌套代码块的时候，需要将其缩进八个空格或者两个制表符。

7.代码语法

要将单词或者短语表示为代码，需要将其包括在反引号( ` ：输入法切换为英文的数字键1)中。如果需要包含的代码内容包含有反引号，那么需要将其包括在两个反引号中。

8.分割线语法

在单独的一行上使用三个或以上的星号、破折号或者下划线，并且该行不能包含其他内容。

 9.链接语法

链接文本放在中括号内[ ]，链接地址放在后面的小括号中( )。链接title是当鼠标悬停在该链接上时会出现的文本，链接的title是可选的，它用双引号包括，用空格分割开放在小括号内链接地址的后边。

这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。

 使用< >来将URL或者邮箱地址转变为可以点击的链接。如果要强调链接，可以在连接前后的小括号外加星号或者破折号。如果要转变为代码则需要加反引号。

10.图片语法

要添加图像，使用感叹号 (!), 然后在方括号内增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

![这是图片](/assets/img/philly-magic-garden.jpg "Magic Gardens")

如果需要给图片增加链接，需要将图片的文本括在方括号内，在方括号后边添加小括号和链接。

11.转义字符语法

要显示原本用于格式化 Markdown 文档的字符，需要在字符前面添加反斜杠字符 \ 。

\* Without the backslash, this would be a bullet in an unordered list.

 12.内嵌HTML标签

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到 Markdown 文本中即可。