一、概述

自从接触Markdown编写博客，我就爱上了这个标记语言。原因是它完全是纯文本编写，并且多平台都支持，例如GitHub、、简书、知乎等，而且非常简单，极易上手。其性质完全与txt文本一样，只是后缀名是md而已。

Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件Word 或Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。

Markdown 的理念：能让文档更容易读、写 和 随意改。常用的标记符号也不超过十个，这种相对于更为复杂的HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

使用 Markdown 的优点：

专注你的文字内容而不是排版样式。轻松的导出 HTML、PDF 和本身的 .md 文件。纯文本内容，兼容所有的文本编辑器与字处理软件。可读，直观。适合所有人的写作语言

帮助文档：

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

二、兼容HTML

Markdown 兼容 HTML，而不是取代HTML，Markdown 的语法种类很少，只对应HTML 标记的一小部分。

HTML是一种发布的格式，Markdown是一种书写的格式。Markdown 的格式语法只涵盖纯文本可以涵盖的范围。不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。不需要额外标注是 HTML 还是 Markdown 。

三、Markdown语法摘要

3.1 区块元素

段落和换行：一个Markdown段落前后都需要保证有一个空行【空行的定义是显示上看起来像是空的便会被视为空行】，并且段落不该用空格或制表符来缩进，我们可以插入空格的转义字符   来实现缩进效果。除了添加空行来进行换行，我们也可以使用 Html 标签<br/>来进行换行。标题：对应HTML中的 6 级标题，使用对应数量的井号来表示相应标题。区块引用 Blockquotes：每行的最前面加上 >，区块引用可以嵌套(例如：引用内的引用)，只要根据层次加上不同数量的 > 即可。

Markdown 支持有序和无序列表：

无序列表：使用星号、加号或是减号作为列表标记有序列表：则使用数字接着一个英文句点 注意：在列表标记上使用的数字并不会影响最后输出的HTML结果，换句话说你的数字只是个标识，不是最终结果。分割线：你可以在一行中用三个以上的星号、减号、底线 来建立一个分隔线，行内不能有其他内容，但你可以在星号或是减号中间插入空格。代码区块：要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以。一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。 在代码区块里面，& 、< 和> 会自动转成HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理。

不过我更喜欢也是经常使用的是如下代码区块方式，多个反引号的形式，这样可以指定代码的类型，可以对应进行高亮。

```java 代码 ```

 3.2 区段元素

链接：Markdown 支持两种形式的链接语法 行内式：[链接文字](网址链接 "链接的 title 文字") 示例： [百度](http://www.baidu.com "鼠标悬浮提示")注意：链接的 title 文字是可以省略。参考式：[链接文字][自定义的链接ID]  [id]: 网址链接  "链接的 title 文字" 可以在文件的任意地方定义链接辨别标签【自定义链接ID】可以有字母、数字、空白和标点符号，但并不区分大小写隐式链接标记功能是参考式的一种缩略形式，也就是链接辨别标签【自定义链接ID】为空白的情况，这种情形下链接标记会视为等同于链接文字强调：Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用<em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成<strong>。图片：图片的形式完全与上面的 链接 类同，不同点是在 链接 的前面添加一个感叹号。

3.3 其它

1. 自动连接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱【简介略】，只要使用尖括号包起来即可。Markdown 会自动将其转成链接，一般网址的链接文字就和链接地址一样，这样便可使用这种简便形式，示例：

<http://example.com/> Markdown 会转为： <a href="http://example.com/">http://example.com/</a>

2. 反斜杠

由于使用少数特殊字符来进行定义MarkDown格式，但是若想使用这些少数特殊字符作为普通字符，那么就需要进行转义，以下这些符号前面加上反斜杠来帮助插入普通的符号：

\ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号

3. 表格

Tables | Are | Cool --------------|---------------|------ col 3 is | right-aligned | $1600 col 2 is | centered | $12 zebra stripes | are neat | $1

注意：标题下的- 是没有数量限制的。