关于 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 中，如需显示有特定意义的符号，如：*,# 等，可使用 反斜杠 \ 进行转义。可对如下字符进行转义：
*
`
*
_
{}
()
#
+
-
.
!
-
即：每年的公历五月份 ↩
