20170714 Markdown的使用
一. 前言
主要是因为最近很多关注的博主有介绍利用Markdown编辑器写文章的便利性，而且在“博客园”网站上有“编辑器-Markdown编辑器”的选择，所以想趁这个机会学习一下。
二. 正文
概述[1]
Markdown 的目标是实现「易读易写」。可读性，无论如何，都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，而最大灵感来源其实是纯文本电子邮件的格式。
几种基本语法
1. 首行缩进[2]
由于markdown语法主要考虑的是英文，所以对于中文的首行缩进并不太友好，两种方法都可以完美解决这个问题。
* 把输入法由半角改为全角。 两次空格之后就能够有两个汉字的缩进。
* 在开头的时候，先输入下面的代码，然后紧跟着输入文本即可。分号也不要掉。 直接写
半方大的空白 或 
全方大的空白 或 
不断行的空白格 或 
2.分级标题
第一种写法：行首插入 1 到 6 个# ，对应到标题 1 到 6 阶。
# H1
## H2
第二种写法：通过在文字下方添加“=”和“-”，他们分别表示一级标题和二级标题。
This is an H1
=============
This is an H2
-------------
3. 列表
Markdown 支持有序列表和无序列表。
3.1 无序列表
使用星号、加号或是减号（都需要加空格）作为列表标记：(* Red)，(+ Red)
3.2 有序列表
有序列表则使用数字接着一个英文句点：(1. Bird)
当然，项目列表很可能会不小心产生，像是下面这样的写法，换句话说，也就是在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠。
- 如果要在列表项目内放进引用，那 > 就需要缩进；
- 如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符；
- 列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。
3.3 定义型列表[3]
定义型列表由名词和解释组成。一行写上定义，紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
Markdown
: 轻量级文本标记语言，可以转换成html，pdf等格式（左侧有一个可见的冒号和四个不可见的空格）
代码块 2
: 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格）
代码块（左侧有八个不可见的空格）
4. 引用
Markdown 标记区块引用是使用类似 email 中用\ > 的引用方式。 区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的> 。
5. 分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
6. 链接
Markdown 支持两种形式的链接语法： 行内式（使用较多）和参考式两种形式。不管是哪一种，链接文字都是用 [方括号] 来标记。
6.1 行内式：
只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：
[This link](http://example.net/) has no title attribute.
[This link](http://example.net/) has no title attribute.
6.2 参考式：
参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：
This is [an example][id] reference-style link.
接着，在文件的任意处，你可以把这个标记的链接内容定义出来：
[id]: http://example.com/ "Optional Title Here"
链接内容定义的形式为：方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字；接着一个冒号；接着一个以上的空格或制表符；接着链接的网址；选择性地接着 title 内容，可以用单引号、双引号或是括弧包着。下面这三种链接的定义都是相同：
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
6.3 自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：
<http://example.com/>
在浏览器里面，这段字串（其实是 address@example.com）会变成一个可以点击的「address@example.com」链接。
6.4 锚点
网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。Markdown Extra 只支持在标题后插入锚点，其它地方无效。
在你准备跳转到的指定标题后插入锚点{#标记}，然后在文档的其它地方写上连接到锚点的链接。
## 0. 目录{#index}
跳转到[目录](#index)
7. 斜体或粗体
Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被* 或_ 包围的字词会被转为（斜体），用两个 * 或\ _ 包起来的话，则会被转成（粗体）。但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~
8. 图片
Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。
8.1 行内式：( )
一个惊叹号 !；接着一个方括号，里面放上图片的替代文字；接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。
８.2 参考式：(![Alt text][id])
[id]是图片参考的名称，图片参考的定义方式则和连结参考一样：[id]: url/to/image "Optional title attribute"
９. 反斜杠
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
自动链接
9. 代码
如果要标记一小段行内代码，你可以用反引号把它包起来（`）；
要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以。（开头加4个空格或一个tab即可，markdown会在生成的html代码包上 pre code 标签，一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。）
10. 公式[3]
10.1 $ 表示行内公式：
代码：
质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。
显示效果：
质能守恒方程可以用一个很简洁的方程式 E=mc2E=mc2 来表达。
10.2 $$ 表示整行公式：
代码：
$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$
11. 表格[3]
语法说明：
不管是哪种方式，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐。
代码：
简单方式写表格：
学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92
三. 参考文献
[1]Markdown - 语法说明[ EB/OL ].http://www.markdown.cn/
[2]mountzf.markdown中实现首行缩进的两种方法[ EB/OL ].http://blog.csdn.net/mountzf/article/details/51714763.2016-06-19
[3]梵居闹市.Markdown 语法手册 （完整整理版）[ EB/OL ].http://blog.leanote.com/post/freewalk/Markdown-语法手册#title.2015-07-27
因为本文有些内容是参考其他的博文，相关参考网址已经贴在上面，参考部分也已经注明。但是不知道是否允许，如果不允许，请告知我，谢谢！
浙公网安备 33010602011771号