markdown语法

http://www.ituring.com.cn/article/504

常用语法
3.2.1 标题
语法标记：#
（#号+空格）作用域：行语法位置：前置（同行前置，写在目标文字开头）语法方向：后向好用等级：（5颗星）解说**：#
支持6个级别的标题，#
号的数量代表标题的级别。

图1-1. 6级标题

语法标记：=
、-
（等号、减号）作用域：行语法位置：后置（写在目标文字下方，类似给文字加底线）语法方向：前向（对前一行内容有效）好用等级：（2颗星）解说：=
、-
支持2个级别的标题，=
标记一级标题，-
标记二级标题。原则上符号数量不限，但各编辑器支持方式略有差异。后置语法在Markdown中并不常用，所以，这种标记方式了解即可。

图1-2. 2级标题

3.2.2 分割线
语法标记：***
、---
、___
（3个星号、减号、底线）作用域：行（空行）语法位置：前置（写在空行行首）语法方向：后向好用等级：（4颗星）解说：***
、---
或___
将一个空行标记为分割线，一般分割线前后也会各留一个空行。华丽的分割线是部分写手的钟爱，不用也无损大雅，各取所需吧。

图2. 两种分割线写法

3.2.3 列表
标记符号（有序列表）：1.
（序号数字+点号+空格）标记符号（无序列表）：*
、+
、-
（注意空格符号后面有空格）作用域：行语法位置：前置语法方向：后向好用等级：（5颗星）解说：列表有有序和无序之分。--有序列表，在逻辑顺序上具有先后关系。--无序列表，条目之间只做横向比较或罗列。另，结合Tab
缩进可实现列表的嵌套，比如在一个条目下还有3个子条目，则3个子条目仍然可以写成低一级别的列表。合理运用列表，文章逻辑条理更清晰，结构层次更分明。

图3. 两种列表形式

3.2.4 引用
标记符号：>
（大于号+空格）作用域：段语法位置：前置（添加在段首，第一行之前）语法方向：后向好用等级：（5颗星）解说：在需要引用的段落前加上">"和空格，如：> 光明源于黑暗，黑暗涌现光明
。引用也可以嵌套。另外，也有同学给标题添加引用标记，展现效果同样出色。

图4. 引用

3.2.5 链接
语法符号：
（[ ]中放锚文本，()中放链接地址）如：
作用域：区间（锚文本）语法位置：端置语法方向：对向好用等级：（4颗星）解说：根据不同使用场景，文字链接有内联和引用两种方式。--内联方式，满足一般使用需求，直观方便，即用即写。--引用方式，适合添加多个网址的文章，可以避免在正文中出现大量网址，保持编辑可读性；也适合同一网址多处引用，当网址有改动或修改时，只需修改列表即可，无需逐个修改，类似宏定义。

[图片上传中。。。（6）]图5. 文字链接

3.2.6 图片
语法符号：

（[ ]中放图片说明，()中放图片链接）如：

图6.图片

作用域：无（插入性语法，无作用域）语法位置：不限语法方向：无（插入性语法，无方向性）好用等级：（3颗星）解说：江湖传言“字不如表，表不如图”、“一图胜千文”、“无图无真相”云云，图片重要性不言自寓，然而缺少好的图床，完美的语法没有完美的解决方案，一样是没有什么卵用。当然，在上写作非常省心，图片处理就是直接拖进编辑区，这一点真的很贴心。与文字链相同，图片也有 内联和 引用两种方式。

图6. 图片链接

3.2.7 强调
语法标记：* *
、_ _
（星号对或底线对）作用域：区间语法位置：端置语法方向：对向好用等级：（4颗星）解说：强调有3种形式，分别为：单星对* *
斜体强调、双星对** **
加粗强调、三星对*** ***
斜体加粗强调。

[图片上传中。。。（8）]图7. 强调

3.2.8 脚注
语法标记：[^1]
+[^1]:注释内容
（[^1]
是角标，[^1]:注释内容
是对应的注释列表，必须一一对应）作用域：无（插入性语法，无作用域）语法位置：注释点（一般插入在需注释词汇的后面）语法方向：无（插入性语法，无方向性）好用等级：（4颗星）解说：写文章时，不可避免要用到读者陌生的词汇或典故，就地解释会把文风带偏，不作说明显然治学不严，脚注为此而生。

图8. 脚注

3.2.9 代码
语法标记：
（Tab
缩进或连续空格）、
（号对，注：
号俗称“小句号”，和波浪号在同一按键上）作用域：行语法位置：空格或缩进为前置、号对为端置语法方向：空格或缩进为后向、
号对为对向好用等级：（3颗星）解说：对程序猿（媛）同学来说，要在文章中插入一段代码，怎么办？--代码行：单`
号对可以实现代码行效果；cout<<"hello world!"< --代码区：Tab
缩进或连续空格，实现代码区块的效果（注意代码区要独立成段，且每行都要缩进）。

void main() { cout<<"hello world!"<

图9. 代码

3.2.10 表格
语法标记：|
和-
和:
组合作用域：段、区间语法位置：组合型语法方向：组合型好用等级：（1颗星）解说：表格在Markdown语法中真是个鸡肋，如果非用不可倒也无妨。--|
和|
之间形成单元格。--第一行为表头，内容默认加粗居中。--第二行-
和：
组合，标记本列单元格对齐方式。无:
号，为默认左对齐；两端:
为居中；左、右其中一端:
向该侧对齐。--其余行为普通单元格。注意：（1）第二行不可省略，否则语法不完整；（2）表格必须为整段，中间不能有空行。

| 表头 | 表头 | 表头 | | ------- |:-------:| -----: || 11 |12 |13 || 21 |22 |23 || 31 |32 |33 || 41 |42 |43 |

图10.表格

文／Mr_Professor（作者）原文链接：http://www.jianshu.com/p/8c1d594afd85著作权归作者所有，转载请联系作者获得授权，并标注“作者”。