Markdown 语法详解

关于 Markdown

Markdown 语法的目标: 成为一种适用于网络的书写语言。

一、区块标记

区块标记： 是指内容独占一块，需前后换行，不和其他标记共处一行的标记。

段落： 即是一段连续的文字，可包含*、空格、换行、tab等字符。两个段落之间使用空行分隔。

标题： 代表了文章中主题的层次。
语法： Markdown 中使用连续的 n(1-6) 个 # 分别表示第 n 级标题。(注：# 和后续内容之间应放置一个空格)

列表： 就是一组相关信息的集合。简书中的列表分为有序列表和无序列表。
1) 有序列表语法：使用数字 + . 作为项目符号，项目符号和正式列表项目之间有一个空格。

2) 无序列表语法：使用 + 、- 或 * 作为项目符号，项目符号和正式列表项目之间有一个空格。

*无序列表的项目符号可使用 ,+,- 效果是相同的。
列表与后续内容之间需要一个空行隔开，即：列表是一个段落
列表允许多层次嵌套
可以在项目中包含段落，只需将段落前添加一个 tab 或 4 个空格

3) 分割线语法：使用 3 个连续的 * 即可得到一个分割线。

4) 引用语法：在行头加上 > 即可。

大于号和文字必须有一个空格
可以在每行之前加 > ，也可以在段落之前加 1 个 >
引用内部可以使用其他 Markdown 标记
引用内部可以添加新的引用，只需再加一个大于号

二、行内标记

1) 斜体：使用前后各 1 个 ( _ 或 * ) 包含的文字是斜体文字。
2) 粗体：使用前后各 2 个 ( _ 或 * ) 包含的文字是斜体文字。
3) 删除线：使用前后各 2 个 ~ 包含的文字是删除文字。
4) 粗斜体：在 (或 _ ) 中嵌套 (或) 或在 _ (或) 中嵌套 ** (或 _ ) 即可得到粗斜体。

三、图片

1)行内图片：图片和图片地址卸载一起。

语法：
[图片名称] ( 图片url )

2)引用图片：图片和图片地址分开书写。_

语法：
![图片标题 image.png ][图片id]
[图片id]:图片url 。

四、链接

1) 行内链接

语法：
[链接名称](链接 url “链接ttle")

2) 引用链接

语法：
[链接名称][链接id]
[链接id]:链接 url "链接ttle"

注意事项：链接 id 可使用字母、数字、空格，但不区分大小写。

3) 自动链接

一种简明的链接书写方式。
语法：<链接地址>

五、脚注

为名词提供注释，注释将显示在文章末尾。
语法：
待注释文字[^脚注 id]
[^脚注 id]:注释内容
示例:

Hello May[^may]
[^may]:即：每年的公历五月份

效果：
Hello May^[1]

脚注的注意事项：

脚注 id 必须唯一。
无论脚注 id 如何起名，显示时一律标为数字，并且按出现顺序排列。

六、双标记

1) 行内代码块

语法：使用两个 ` 将代码包含起来。
示例代码

在 OC 中输出 Hello May : `MSLog(@"Hello May");`

效果
在 OC 中输出 Hello May : MSLog(@"Hello May");

2) 多行代码块

语法：只需要每行都缩进 4 个空格即可，或者使用```框起来。
示例代码
```
$(function(){
alert("Hello May!");
});
/```
效果

$(function(){
  alert("Hello May!");
});

注意事项：
1.在代码区块内部，", <>,& 将会自动转换为转义字符
2.在代码区块内部，Markdown 标记将保持原样，即：星号()就是星号()，不被解释为特殊标记，这样就可以不能继续使用 Markdown 语法了**

七、表格

语法：
1、第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
2、列于列之间用管道符 | 隔开。表格每一行两边的管道符可省略。
3、第二行还可以为不同的列指定对齐方向。标题默认为居中对齐，内容默认为左对齐；在 - 左边加上 : 就是左对齐；在 - 右边加上 : 就是右对齐；在 - 两边都加上 : 就是居中对齐。
示例代码

|姓名|性别|学号|成绩|
|:---|:---|:---:|---:|
|喜羊羊|男|001|220|

效果

姓名	性别	学号	成绩
喜羊羊	男	001	220

八、其他问题

1.Markdown 与 html 的关系

1).HTML 是一种发布的格式，Markdown 是一种书写的格式。
2).Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
3).在 Markdown 中可直接使用 HTML 标签，但需要注意

对于 HTML 区块元素――如 div、table、pre、p 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符(tab)或空格来缩进

HTML 的行内标签——如 span、cite、del 可以在 Markdown 的段落、列表或是标题里随意使用。

在 HTML 的区块标签中的 Markdown 标签是没有效果

2.特殊字符的自动转换

在 HTML 文件中，有两个字符需要特殊处理： < 和 &，必须使用转义字符：& lt ; 和 & amp ;

Markdown 中，你可以自由的书写 < 和 &，编辑器会智能的进行判断：当这些符号用于 HTML 标签中，他们将保留原型；当他们单独使用时，将会转换为字符实体。

在代码块中，它们将统统被转换为字符实体，即：原样显示。

3.Markdown 中的转义字符

Markdown 中，如需显示有特定意义的符号，如：*,# 等，可使用反斜杠 \ 进行转义。可对如下字符进行转义：

*
`
*
_
{}
()
#
+
-
.
!

即：每年的公历五月份 ↩