Markdown入门指南

一、编写Markdown的工具

window系统：MarkdownPad
Mac OS X：Mou

二、Markdown官方文档

• 创始人 John Gruber 的 Markdown 语法说明
• Markdown 中文版语法说明

三、Markdown简要语法

1.标题

类 Atx 形式：

    # 一级标题    ## 二级标题    ### 三级标题    #### 四级标题    ##### 五级标题    ###### 六级标题

类 Setext形式：

    最高阶标题    =========    第二阶标题    ---------

注意：
* 类Atx形式的标题有六级，类Setext形式的标题只有两级。
* 类Atx形式中，符号与文字之间要间隔一个空格，这是最标准的Markdown语法。
* 类Setext形式中，下面的“=”和“-”数量任意。

2.引用

    > 这里是引用语句1    > 这里是引用语句2    > 这里是引用语法3

注意：
* 同样，符号与文字之间要间隔一个空格。
* 可以只在引用区域的开头加上>，然后其它地方的>省略。
* 引用区域内可以使用Markdown语法，包括标题、列表，代码块以及引用本身。
* 如果要结束引用，只需将引用区域与不引用区域隔开一行即可。

3.列表

无序列表：

    * 第一项    * 第二项    * 第三项    亦或者    + 第一项    + 第二项    + 第三项    亦或者    - 第一项    - 第二项    - 第三项    锯齿状分级    * 第一项        * 第二项            * 第三项

注意：
* 符号与文字之间要间隔一个空格。
* 如果三项不是左对齐，而是类似于锯齿状的话，那么第一行开头是一个实心圆点，第二行开头是一个空心原点，第三行开头是一个实心方形点，最多分三级。

有序列表

    1. 第一项    2. 第二项    3. 第三项    锯齿状分级    1. 第一项        2. 第二项            3. 第三项

• 符号与文字之间要间隔一个空格。
• 如果三项不是左对齐，而是类似于锯齿状的话，那么第二行的序号将会从1开始(无论当前所写的序号是多少)，第三行类似，最多分三级。

4.图片与超链接

图片

    ![测试图片](https://1tpic.com/images/2017/07/15/MarkdownTest.md.jpg)

• 前面的方括号中是图片的名字，后面的圆括号中是图片的链接地址。
• 这是使用了图床来保存图片。常见的免费图床可以参考这篇文章的介绍：盘点好用的免费图床。

超链接

    //行内式    [百度](https://www.baidu.com/)    //参考式    [百度][id]    [id]:https://www.baidu.com/ "这是国内一家搜索引擎"

• 行内式前面的方括号中是超链接的名字，后面的圆括号中是超链接的地址。
• 参考式第一行后面的方括号与第二行中方括号的内容要一致，可以是任意内容，只是用来索引地址而已。
• 参考式中的双引号中的内容是鼠标停放在超链接“百度”上时，显示的文字，也可以用圆括号来包裹。
• 参考式第一行和第二号不一定要靠在一起，可以一个放在开头，一个放在结尾。这种方式的引用比行内式更加的简洁好看。

5.斜体与粗体

    *斜体*    **粗体**

• 实现斜体的代码中，星号与文字之间不能有空格。而粗体则没有这个限制。

6.表格

|第一列|第二列|第三列||:--|---:|:----:||七|一|六||三|五|九||四|八|二|

实现效果：

第一列 第二列 第三列 七 一 六 三 五 九 四 八 二

* 可以看到，有冒号和横线的那一行，是不会出现在浏览页面中，那一行是用来定义数据展现的样式：居左，居中和居右。冒号在左边是居左，冒号在右边是居右，两边都有冒号则是居中，两边都没有冒号默认居左。横线的数量可以任意。
* 定义行的上面只能有一行，该行则是表格的表头行。

7.分割线

    ***

8.代码块

    “```Markdown        >这里是应用    ```”

• 由于不能在代码块中再使用代码块语法，因而这里使用“”括住具体语法，使用时需要将“”去掉。
• 这里的`是英文输入法下，按键盘上1键左边的那个键输入的，而不是单引号。
• 这里的Markdown是指代码块中的代码是Markdown代码，也可以是Java，Ruby等等。

四、Markdown与Html的关系

Markdown兼容Html语法。比如在Markdown中使用html的标签br，同样可以实现在Html中的效果。

但反过来就不行了，不能在Html中使用Markdown语法。

参考：
1. Markdown——入门指南
2. Markdown 语法说明 (简体中文版)