MarkDown标记语言语法

PS（2016.04）: 三年前最开始学习 markdown 的时候记录的笔记，最近在重新整理之前的笔记，再次翻起与 markdown 相关的一系列笔记，这里重新整理一下。

基础语法规则

行内文字格式化

1. 加粗：用两个 * 包裹文字即可，粗体。
2. 斜体：用一个 * 包裹文字即可，斜体。
3. 粗斜体：用三个 * 包裹文字即可，粗斜体。

角注

角注使用[^1]这种方式添加^[1]。具体使用方式如下：

引用角注[^1]

[^1]: 角注内容

图片和链接

• 自动链接：<http://example.com/> 得到的是 http://example.com/
• 带文字链接：[蘑菇街](http://www.mogujie.com) 得到的就是 蘑菇街

向页面中插入图片的方式与带文字链接类似，只不过前面多了个感叹号：

![当图片出不来显示的文字](http://upload-images.jianshu.io/upload_images/2283-476c245df0fe29fa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

当图片出不来显示的文字

图片上带链接？只要图片整体当文字然后用文字链接的方式就可以了。

段落与换行

在 HTML 页面中，段落使用 <p></p> 标签包裹，而换行则使用 <br />。在 Markdown 的语法中，段落直接使用空行隔开即可，而段内换行则是行最后跟两个空格，再换到下一行继续书写。示例如下：

我是一段文字

我是一段文字，但我下面还有段内换行文字  
哈哈，我是段内换行的文字，你会发现上一行最后还有两个空格哦！

我是一段文字

我是一段文字，但我下面还有段内换行文字
哈哈，我是段内换行的文字，你会发现上一行最后还有两个空格哦！

标题

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。几级标题加几个 # 号。示例如下：

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

注：不推荐无节制地加标题，每个项目最好提前约定好标题级数的使用规范。

引用区块

在 HTML 页面中，引用区块使用的是 blockquote 标签，Markdown 语法提供了一种更方便的方式，效果其实前面的注中已经展现了，在要引用的段文字最前加 >即可。（如果有多段，则每一段最前都要加）

> 我是引用内容
>
> 我也是引用内容

我是引用内容

我也是引用内容

列表

列表包括有序列表和无序列表，有序列表用数字开头，而无序列表使用 * 或 - 或 + 开头，之后跟一个空格再添加内容，子列表需要相对父列表向右多两个空格且不能加空行。示例如下：

无序列表：

 - 无序列表1
   + 无序子列表
 - 无序列表2

• 无序列表1
  • 无序子列表
• 无序列表2

有序列表：（事实上，只要是数字就行，无需关注顺序，即便先写 2 再写 1 最终得到的也是按顺序排列的列表）

2. 有序列表1
  a. 有序子列表
1. 有序列表2

2. 无序列表1

• 无序

1. 无序列表2

如果列表之间加了空行，就会被解释成两段内容，也许得到的就并不是你想要的了。

代码块

代码块分两种，内联代码及块代码，对应于 HTML 中的 code 和 pre 标签。内联代码很简单，用 ` 号（键盘上数字 1 左边那个键）包裹起来即可。而块代码则有两种方式：

1. 使用三个 ` 来包裹代码块，这种方式可以自定义语法高亮

2. 将代码块向右缩进四个空格，这种方式不会带任何语法高亮

    ```javascript
    console.log('hello world');
    ```    
   

这时，你看到的效果会是：

console.log('hello world');

分隔线

当一行元素为 * * * 的时候，就是下面这种效果的分隔线了：

1. 角注 ↩