如何写好MarkDown

MarkDown

参考文献：MarkDown语法

MarkDown作为一个便捷又高效通用的文档编写工具，易读易写，同时可以导出为Word、PDF、HTML，本身的.md格式文件，很多博客网站、GitHub、简书等都是可以通用的。

语法主要以标记符号为主，在日常文档编写中十分便捷，下面推荐一些常用的语法和标记符号，提高排版，更加优雅的记录。

1. 标题

创建标题，可以通过添加井号来实现（#）。#的数量可以来标记标题的级别，通常数量越多，级别越低，# 与标题文字之间需要空格分开。

• 第一种（使用一组 # ，最多标题到六级）

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

• 第二种（使用一对 # ，最多标题到六级）

  # 一级标题 #
  ## 二级标题 ##
  

• 第三种（使用“=”表示一级，“-”表示二级）

  这是一级标题
  ======
  这是二级标题
  --------
  

2. 列表

列表分为有序列表和无序列表，一级实心圆，二级空心圆

无序列表

使用 * ， +， - 来创建，转为html文件的时候为ul > li

### 无序列表
* 1
	* 1.1
	* 1.2
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3

• 1
  • 1.1
  • 1.2
• 2
• 3

有序列表

以第一个为开始递增，使用阿拉伯数字 + 英文" . " + 空格

### 有序列表
3. 列表1
2. 列表2
1. 列表3

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

3. 区块引用

对某个或某块语句做特殊表示，通过使用 " > " + 空格

• 创建区块引用

  > 这是一个区块引用
  

  这是一个区块引用

• 创建多个段落的区块引用

  > 这是第一段区块引用
  > 这是第二段区块引用
  > 
  > 这是第三段区块引用
  

  这是第一段区块引用
  这是第二段区块引用

  这是第三段区块引用

• 嵌套与混合使用区块引用

  > 失败乃成功之母
  	> 我不知道是谁说的
  > 成功乃成功之父
  	> 我不知道有没有人说过，反正我说过
  	
  > ## 标题
  > * 前方高能
  >	> 高能
  > * 前方低能
  > 	> 低能
  

  • 失败乃成功之母

    我不知道是谁说的

  • 成功乃成功之父

    我不知道有没有人说过，反正我说过

  标题

  • 前方高能

    高能

  • 前方低能

    低能

4.分割线

分割线由 * - _(星号， 减号，底线)三个符号的至少3个表示，不用连续

***

---

___

---

---

---

5.链接

超链接语法：[超链接显示名称](超链接地址 "超链接title")

• 链接

  这是百度[链接](http://www.baidu.com)
  

  这是百度链接

• 链接加title

  [name](http://www.baidu.com "名称")
  [home](http://www.baidu.com "首页")
  [支持中文](/home/name "加油")
  

  name
  home
  支持中文

• 网址和Email地址

  <https://www.baidu.com>
  <mail@email.com>
  

  https://www.baidu.com
  mail@email.com

6.图片

图片语法：![图片alt](图片链接 "图片标题")

• 图片

  ![我是图片](https://i-blog.csdnimg.cn/blog_migrate/9468142039978d8168fff271d23cfc39.png  "我是图片")
  

  

• 图片链接

  [![我是图片](https://i-blog.csdnimg.cn/blog_migrate/9468142039978d8168fff271d23cfc39.png  "我是图片")](https://www.baidu.com)
  

  

7.代码框

• 单行：单反引号包起来

  `<p><a href="/home" title="说明"></a></p>`
  

  <p><a href="/home" title="说明"></a></p>

• 多行：3个`

  ```注释
  <p><a href="/home" title="说明"></a></p>
  <p><a href="/home" title="说明"></a></p>
  <p><a href="/home" title="说明"></a></p>
  

  <p><a href="/home" title="说明"></a></p>
  <p><a href="/home" title="说明"></a></p>
  <p><a href="/home" title="说明"></a></p>
  

8.表格

| name | age | sex |
|:-----:|:-----:|
| tony | 20 | 男 |
| Lucy | 18 | 女 |

表头1 | 表头2
--------|-------
Content cell | content cell 
Content cell | content cell 

学号|姓名|分数
-|-|-
001|小红|95
002|小黑|86
003|小白|105

示例：

name	age	sex
tony	20	男
Lucy	18	女

表头1	表头2
Content cell	content cell
Content cell	content cell

学号	姓名	分数
001	小红	95
002	小黑	86
003	小白	105

9.强调

• 粗体

  两个星号（*）或者是两个下划线（_）包起来

  **字体加粗**
  __字体加粗__
  

  字体加粗
  字体加粗

• 斜体

  一个星号（*）或者是一个下划线（_）包起来

  *字体倾斜*
  _字体倾斜_
  

  字体倾斜
  字体倾斜

• 粗体加斜体

  三个星号（*）或者是三个下划线（_）包起来

  ***粗体和斜体***
  ___粗体和斜体___
  

  粗体和斜体
  粗体和斜体

10.转义

转义字符加上反斜杠（\）

* \\
* \'
* \~
* \_
* \-
* \+
* \.
* \!

示例：

• \
• ’
• ~
• _
• -
• +
• .
• !

11.删除线

删除线：左右加上波浪线（~）

~~删除~~

删除