Markdown基本语法指南

Markdown基本语法指南

Markdown的语法分为基本语法与拓展语法两大部分，本文介绍的为基本语法

---

目录

• Markdown基本语法指南
  • 目录
  • 一、标题
    • 1. 下划线形式
    • 2. 井号形式
  • 二、字体
    • 1. 粗体
    • 2. 斜体
    • 3. 粗斜体
  • 三、段落与换行
    • 1. 段落
    • 2. 换行
  • 四、列表
    • 1. 有序列表
    • 2. 无序列表
    • 3. 列表嵌套
    • 4. 列表插入
  • 五、分割线
  • 六、链接
    • 1.链接
    • 2.引用链接
    • 3.网址链接
  • 七、图片
  • 八、引用
  • 九、代码
    • 反引号形式
    • 缩进形式
  • 转义
  • 参考

---

一、标题

1. 下划线形式

一级标题
===
二级标题
---

说明如下：

1. 底线=表示一级标题
2. 底线-表示二级标题
3. 底线符号的数量至少2个
4. 下划线语法只支持两级标题

2. 井号形式

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

说明如下：

1. #的个数表示标题的等级
2. #后需要加一个空格
3. Markdown只支持六级标题

二、字体

1. 粗体

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

2. 斜体

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

3. 粗斜体

***粗斜体内容***
___粗斜体内容___

Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致。为兼容考虑，在单词或短语中间部分加粗的话，请使用星号，斜体同理.

推荐 love**is**bold
不推荐 love__is__bold

三、段落与换行

1. 段落

在不同段落内容中插入空行来创建不同段落

第一段内容

第二段内容

不推荐用空格或者制表符缩进段落

2. 换行

在行结尾插入两个以上空格然后回车即可建立换行

第一行内容，结尾插入两个以上空格然后回车
第二行内容

四、列表

1. 有序列表

数字，英文句点，空格即可创建有序列表

1. 第一列
2. 第二列
3. 第三列

首个数字应保证为1，其余数字可以随意安排

1. 首个数字应保证为1
5. 之后的数字可以不按顺序
3. 最终渲染出的结果会是有序的

渲染结果：

1. 首个数字应保证为1
2. 之后的数字可以不按顺序
3. 最终渲染出的结果会是有序的

2. 无序列表

*/+/-/ 空格 列表内容

3. 列表嵌套

可以通过缩进来进行列表嵌套，无序列表和有序列表可以混合嵌套,但一共只能嵌套三层

1. 有序列表
    + 无序列表
        1. 有序列表
        + 无序列表

渲染结果如下：

1. 有序列表
   • 无序列表
     1. 有序列表
     • 无序列表

4. 列表插入

在保留列表连续性的同时插入其他属性的内容，请对内容用四个空格或一个制表符进行缩进

1. 有序列表
2. 有序列表

    用四个空格或一个制表符缩进插入内容

3. 保证连续性

五、分割线

在单独一段上（前后均有空行）使用三个及以上的*/-/_,同一行内不可有其他字符，但可以在符号间插入空格:

---

* * *

___________

渲染效果如下：

---

---

---

六、链接

1.链接

语法：$超链接显示名$

[博客园首页](https://www.cnblogs.com/ "博客园首页")

渲染结果：
博客园首页
说明如下：

1. 当链接地址出现空格时，请用"%20"代替空格

2.引用链接

同时支持先定义“链接变量”再进行引用，将链接按$[链接名称]:链接地址$的格式定义在文件下方，在正文直接应用链接名称即可

当链接[博客园首页]需要多次使用时，可以定义链接变量多次使用

[博客园首页]:https://www.cnblogs.com/

渲染结果：
当链接博客园首页需要多次使用时，可以定义链接变量多次使用

3.网址链接

使用尖括号可以直接对网址进行引用

<https://www.cnblogs.com/>

渲染结果：
https://www.cnblogs.com/

七、图片

语法：$$

![天野远子](https://images.cnblogs.com/cnblogs_com/blogs/842262/galleries/2453508/o_250410062243_%E8%BF%9C%E5%AD%90.jpg "天野远子")

渲染结果：

说明如下：

1. 图片链接与"图片title"间要有空格
2. 图片链接可以为本地图片也可以为网络图片
3. 图片链接支持相对地址和绝对地址
4. 图片alt是当图片无法正常显示时显示的文本信息，同时也用于SEO

八、引用

在段落前加一个">"来进行引用

> 引用内容

渲染效果如下：

引用内容

说明如下：

1. 多行引用建议在每一行前加入">",引用内容与非引用内容间需要用空行标记为不同段落
2. 建议在每个">"后添加空格
3. 引用中可以嵌套其他Markdown语法，包括引用本身

九、代码

反引号形式

行内代码使用反引号包裹:
`代码`
渲染效果如下
代码
如果所包含的代码本身含反引号，那么转而使用双反引号包裹，且双反引号与作为内容反引号间需要有空格:
`` `代码` ``
渲染效果如下:
`代码`

缩进形式

代码块用Tab键或四个空格进行缩进

    (用Tab键或四个空格进行缩进)第一行
    (用Tab键或四个空格进行缩进)第二行

渲染效果如下
(用Tab键或四个空格进行缩进)第一行

(用Tab键或四个空格进行缩进)第二行

转义

和其他语言一样，对想直接表达符号含义的字符需要进行转义，在字符前加上" \ "实现转义。
以下列出的字符都可以通过使用反斜杠字符从而达到转义目的：

Character	Name
\	backslash
`	backtick (see also escaping backticks in code)
*	asterisk
_	underscore
	curly braces
[ ]	brackets
( )	parentheses
#	pound sign
+	plus sign
-	minus sign (hyphen)
.	dot
!	exclamation mark
|	pipe (see also escaping pipe in tables)

参考

Markdown插入图片 详细例子(本地图片，网络图片，base64) Windows
Markdown官方文档
《了不起的Markdwon》 毕小鹏 电子工业出版社