Markdown语法

基本语法

段落

• 段落由一个或多个连续的文本行组成，它的前后要有一个以上的空行。
• 若某一行只包含空格和制表符，则也会被视为空行。
• 段落内的强迫换行（插入换行符），在插入处先按入两个以上的空格然后回车。

标题

• 在行首插入 1 到 6 个井号# ，对应到标题 1 到 6 阶。

强调

• 星号*或底线_包起来的内容变为斜体
• 两个星号**或底线__包起来的内容变为粗体
• 强调可以直接插在文字中间

区块引用

• 在每行的最前面加上大于号>
• 也可以偷懒只在整个段落的第一行最前面加上>
• 嵌套区块引用只需要根据层次加上不同数量的>>等

小段行内代码

• 要标记一小段行内代码，你可以用反引号`把它包起来
• 要插入反引号，可以用多个反引号来开启和结束代码区段

代码区块

• 推荐方法，在区块行首和区块尾加上三个反引号(```)
• 开头加上一个缩进（4 个空格或是 1 个制表符），建立代码区块
• 在列表中插入时要两个缩进
• 代码区块会一直持续到没有缩进的那一行（或是文件结尾）

列表

• 无序列表使用星号*、减号-或是加号+作为列表标记
• 有序列表使用数字接着一个英文句点1.
• 在行首出现数字-句点-空白时，在句点前面加上反斜杠2017\.
• 列表可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符
• 如果要在列表项目内放进引用，那>的前面就需要缩进
• 如果要放代码区块，该区块就需要缩进两次

分隔线

• 在一行中用三个以上的星号*、减号-、底线_来建立一条分隔线
• 行内不能有其他东西。但可以在符号中间插入空格

插入链接

行内式的链接

• 方块括号后面紧接着圆括号：[显示文字](链接地址)
• 如果需要链接的 title 文字，在链接地址后面，加空格再用双引号把 title 文字包起来。如：[an example](http://example.com/ "Title")
• 如果是链接到同样主机的资源，可以使用相对路径

参考式的链接

• 在链接文字的方括号后再接上另一个方括号，其中填入链接的标记：[an examp][id]
• 然后，可以在文件的任意处，把该标记的链接内容定义出来：
  [id]:http://example.com/ "Optional Title Here"
• 链接内容定义的形式为：

  • 方括号（前面可选择加上最多三个空格来缩进），里面输入链接标记
  • 接着一个冒号，接着一个以上的空格或制表符
  • 接着链接的网址，接着一个以上的空格或制表符
  • 可选接着 title 内容，可以用双引号包着

• 链接标记可以有字母、数字、空白和标点符号，但是不区别大小写

插入图片

• 类似插入链接,分为行内式和参考式
• 区别是在插入时,前面加上感叹号!
• 参考式定义标记的链接内容时不需要感叹号

其他

自动链接

• 直接用尖括号包起来， Markdown 就会自动把它转成链接：
  

反斜杠

• 可以利用反斜杠来插入一些在语法中有其它意义的符号：

\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号