Markdown 基本语法

文中若有错误、侵权等不当的地方还望各位书友及时指正，共同学习进步。
转载请注明出处：http://www.jianshu.com/p/dc99c0e97005

一、标题

# 代表标题的级别
例：

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、字体

• 加粗
  文字两边用两个*括起来
• 斜体
  文字两边用一个*括起来
• 加粗倾斜
  文字两边用三个*括起来
• 删除线
  文字两边用两个~~括起来
  例：

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下：
加粗的文字
倾斜的文字
**斜体加粗的文字**
加删除线的文字

三、段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。

• 区块引用
  标记区块引用是使用类似 email 中用 > 的引用方式
  例：
  > 引用部分
  >> 引用部分
  效果：

引用部分

引用部分

• 列表
  Markdown 支持有序列表和无序
• *无序列表**使用星号、加号或是减号作为列表标记：
  例:

* 列表
+ 列表
- 列表

效果：

• 列表

• 列表

• 列表

有序列表则使用数字接着一个英文句点：
例:

1. 列表
2. 列表
3. 列表

效果：

1. 列表
2. 列表
3. 列表

多级列表
下级列表右移四个空格
例:

* 1. 列表
     *  1.1 列表
         *  1.1.1 列表

• 1. 列表
     • 1.1 列表
       • 1.1.1 列表

• 代码区块
  单行代码：代码两边用`括起来
  多行代码：代码两边用```括起来
  例：

func swap<T>(_ nums: inout [T], _ p: Int, _ q: Int) {
    (nums[p], nums[q]) = (nums[q], nums[p])
}

四、分割线

三个或者三个以上的 - 或者 * 都可以。
示例：

---
----
***
*****

效果如下：

---

---

---

---

五、图片

语法：

markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

[图片上传失败...(image-2c42eb-1518165915948)]
[图片上传失败...(image-232134-1518165915948)]

详细叙述如下：

一个惊叹号 !
接着一个方括号，里面放上图片的替代文字
接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。

示例：

![cat](http://upload-images.jianshu.io/upload_images/2549840-02c3aab4ca650cfc.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下：

六、表格

表格属性分别用|分开，:用于对齐方式的设置
例如：

| 姓名  | 性别 | 年龄 |
| :---: | :--- | ---: |
| 张三  | 男   |   20 |

姓名	性别	年龄
张三	男	20

七、链接

语法：

要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

例如：

这是[我的博客](https://sakyaa.github.io/)哦

这是我的博客哦