Markdown 学习小结 | Imagine Blog

type

status

date

slug

summary

1 基本语法

1.1 Markdown 标题语法

要创建标题，请在单词或短语前面添加井号 #。其中，# 的数量代表了标题的级别。需要注意的是，井号后面需要一个空格以考虑兼容问题。

1.2 Markdown 段落

要创建段落，请使用空白行将一行或多行文本进行分隔。不要用空格(spaces)或制表符(tabs)缩进段落。

1.3 Markdown 换行语法

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行(<br>)。几乎每个 Markdown 应用程序都支持两个或多个空格进行换行，称为结尾空格(trailing whitespace)的方式。同样的，几乎每个 Markdown 应用程序也都支持另一种换行方式：HTML 的 <br> 标签。所以，为了兼容性，请在行尾添加“结尾空格”或 HTML 的 <br> 标签来实现换行。

1.4 Markdown 强调语法

简单来说，就是斜体一颗星 *，粗体两颗星 **，粗斜体三颗星 ***。

1.5 Markdown 引用语法

要创建块引用，请在段落前添加一个 > 符号。块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，需要进行试验以查看哪些元素有效。

1.6 Markdown 列表语法

1.6.1 有序列表

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

1.6.2 无序列表

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

1.7 Markdown 代码语法

要将单词或短语表示为代码，请将其包裹在两个反引号(`)中。

1.7.1 转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。

1.8 Markdown 分隔线语法

要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容，以上三个分隔线的渲染效果看起来都一样。为了兼容性，请在分隔线的前后均添加空白行。

1.9 Markdown 链接语法

链接文本放在中括号([])内，链接地址放在后面的括号(())中，链接title可选。

1.9.1 给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格( )分隔。

1.9.2 网址和Email地址

使用尖括号(<>)可以很方便地把URL或者email地址变成可点击的链接。

1.10 Markdown 图片语法

要添加图像，请先使用感叹号(!), 然后在方括号中([])增加替代文本，图片链接放在圆括号(())里，括号里的链接后可以增加一个可选的图片标题文本。如果还需要给图片增加点击链接，请将图像的 Markdown 括在方括号中，然后将点击链接添加在圆括号中。

1.11 Markdown 转义字符语法

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

1.12 Markdown 内嵌 HTML 标签

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

学习自Markdown 官方教程

以下是本文的MarkDown语法