初识 Markdown

一、概述

自从接触Markdown编写博客，我就爱上了这个标记语言。原因是它完全是纯文本编写，并且多平台都支持，例如GitHub、CSDN、简书、知乎等，而且非常简单，极易上手。其性质完全与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

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