Markdown语法详细

本文较长，可以先看Markdown十五分钟快速入门（typora）

1.1 基础语法

1.1.1 字体

1.1.1.1 标题

在Markdown语法中有两种标记：底线（-/=)以及#。

底线的语法：

底线语法
-------

或

底线语法
=======

渲染后：

#的语法：

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

渲染后：

语法说明：

1. 一行中的开头码入#即可渲染出标题
2. #的个数即为标题的等级
3. Markdown最多支持六级标题
4. 在#号后面加上空格（严格语法）
5. 底线=为一级标题
6. 底线-表示二级标题
7. 底线符号多少个都可以（typora貌似渲染不出来）
8. 建议使用#，比底线易于维护

typora标题自动编号

---

1.1.2 粗体和斜体

  在Markdown中，粗体由两个 * 或者两个 _ 夹起来，斜体由一个 * 或者一个_加起来。

粗体的语法：

**加粗的内容**
__加粗的内容__

渲染后：

粗体的语法：

*斜体的内容*
_斜体的内容_

渲染后：

语法说明：

1. 建议粗体使用两个 * 包裹，斜体使用一个 * 包裹
2. 标记内部尽量不要有空格

---

1.1.2 列表

  在Markdown中支持有序列表和无序列表，有序列表用数字序号+英文句号+空格+列表内容，无序列表则用-或+或*+列表内容。

有序列表语法：

- 吃饭

+ 吃饭

* 吃饭

渲染后：

语法说明：

1. 无序列表三种方法都是可以的
2. 列表中可以嵌套列表
3. 有序列表与无序列表可以相互嵌套
4. 列表减少按tab，列表增加缩进按shift+tab

---

1.1.3 分割线

  在Markdown中，分割线由3个以上的*或者-或者_来标记。

分割线语法：

***

---

___

渲染后：

语法说明：

1. 分割线必须使用三个以上的标记符
2. 可以在其中加入空格

---

1.1.4 图片

分割线语法：

![图片替代文字](图片地址)

渲染后：

语法说明：

1. 图片地址可以是本地图片的地址也可以是网络图片的地址。
2. 图片代替文字在图片无法正常显示时会比较有用，正常情况下可以为空。
3. 一般建议将图片保存到本地，网上的图片链接会变。

---

1.1.5 链接

1.1.5.1 文字链接

  文字链接就是把链接地址直接写在文本中。语法是用方括号包裹链接文字，后面紧跟着包裹的链接地址。

[链接文字](链接地址)

  上述写法没有任何问题，但是如果链接地址过于长，就会使得代码的可读性变差，所以我推荐下面的写法。

代码：

[链接文字][链接标记]
在文章底部或者其他地方定义链接标记
[链接标记]:链接地址

我们常用的网址有[CSDN]

[CSDN]:https://www.csdn.net/

或者
我们常用的网址有[CSDN][1]
	
[1]:https://www.csdn.net/

渲染后：

  如上图所示，把链接地址在某个地方定义好，然后在正文中通过“变量”来引用，可读性一下子就高了，这种方法叫做引用链接。

---

1.1.5.2 网址链接

  在Markdown中，将网络地址或者邮箱地址使用<>包裹起来会被自动转化为超链接。

语法：

<链接地址>

渲染后：

https://www.csdn.net/

---

1.1.6 行内代码和代码块

1.1.6.1 行内代码

  在Markdown中，行内代码语法如下：

`行内代码`

---

1.1.6.2 代码块

  在Markdown中，代码块以tab键或者四个空格或者~~~+相应的语言。

代码：

~~~C
~~~

或者

四个空格

或者

tab键

渲染后：

#include <stdio.h>
int main(void)
{
    printf("Hello World!");
    
    return 0;
}

语法说明：

1. 使用tab键不够直观建议使用~~~+相应的语言的方法可以语法高亮

---

1.1.7 引用

  在Markdown中，引用由>和空格和被引用内容来标记

语法说明：

1. 引用可以嵌套
2. 引用中可以嵌套有序列表和无序列表

---

1.1.8 转义

  当我们想在Markdown文件中插入一些标记符号，但是又不想让这些符号被渲染时，可以使用\进行转义。

\特殊符号

  可以被转义的特殊符号如下：

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

---

2.1 扩展语法GFM

2.1.1 删除线

语法如下：

~~删除线~~

渲染后：

删除线

---

2.1.2 表情符号

  使用:包裹表情代码

:表情代码:

示例：
😄

更多表情符号参考链接

---

2.1.3 表格

语法：

| 表格1 | 表格2 |
|--|--|
| 内容1 | 内容2 |

渲染后：

表格1	表格2
内容1	内容2

语法说明：

1. 单元格之间用|来分隔
2. 单元格之间的空格会被无视
3. 表头和其他行使用-来分割，没有个数限制
4. 表头对齐方式
   *左对齐（默认）: :
   *右对齐 : -:
   *居中对齐 :-:
5. 表格中不能插入引用块、代码块
6. 建议直接插入表格

---

2.1.4 任务列表

语法

  - [x] 待办项目	已办
  - [ ] 待办项目	未办

渲染后：

• 待办项目 已办
• 待办项目 未办

语法说明：

1. 任务列表以-和空格开头，由[+空格/x+]，组成
2. x推荐使用小写
3. 当方括号中的字符为空格时，复选框是未选中的状态，为x时是选中状态。

---