学习 Markdown 基础语法

一、标题

1、使用 # 表示

有几个 # 就表示几级标题，最多支持到六级标题。

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

2、使用 = 和 - 表示

在文本下一行紧跟 = 和 -，这种方式只能表示一级标题和二级标题

这是一级标题
============

这是二级标题
------------

二、段落格式

1、段落

两种方式：

• 方式一：段落后紧跟两个空格
• 方式二：使用一个以上的空行

2、字体

粗体使用 ** 包裹文字，斜体使用 * 或 _ 包裹文字。

语法示例：

**粗体**
_斜体1_
*斜体2*
***粗斜体1***
_**粗斜体2**_
**_粗斜体3_**

效果展示：

• 粗体
• 斜体1、斜体2
• 粗斜体1、粗斜体2、粗斜体3

3、分隔线

使用三个以上的 * 或 - 或 _ 进行表示，分隔线所在行可以包含空格，但分隔线的前一行不能存在内容。

语法示例：

***

- - -

___

效果展示：

---

---

---

4、下划线

是通过 HTML 的 <u> 标签来实现的。

语法示例：

<u>删除线</u>

效果展示：

删除线

5、删除线

使用 ~~ 包裹文字。

语法示例：

~~删除线~~

效果展示：

删除线

6、脚注

用于补充文字说明，脚注的 : 标记后需要有空格。

语法示例：

这是一段普通文本[^test]。

[^test]: 这是脚注内容

效果展示：

这是一段普通文本¹。

三、列表

1、无序列表

使用 * 或 + 或 - 作为列表标记，这些标记后面要添加一个空格，然后再填写内容

语法示例：

* 选项1
- 选项2
+ 选项3

效果展示：

• 选项1

• 选项2

• 选项3

2、有序列表

使用数字并加上 . 来表示，数字后无空格， . 标记后面要添加一个空格。

语法示例：

1. 选项1
2. 选项2

效果展示：

1. 选项1
2. 选项2

3、列表嵌套

只需要在子列表前添加四个空格。

语法示例：

- 选项1
    1. 子选项1
    2. 子选项2
- 选项2
    - 子选项1
    - 子选项2

效果展示：

1. 选项1
   1. 子选项1
   2. 子选项2

• 选项2
  • 子选项1
  • 子选项2

四、区块引用

区块引用是在段落开头使用 > ，然后后面紧跟一个空格符号。可以进行多层嵌套，也可以在列表中使用区块引用，或者在区块引用中使用列表。

语法示例：

> 区块引用

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

- 选项1
    - 子选项1
    > 列表中使用区块引用
- 选项2

> 区块引用中使用列表
> 1. 选项1
> 2. 选项2

效果展示：

区块引用

最外层

第一层嵌套

第二层嵌套

• 选项1
  • 子选项1

  列表中使用区块引用

• 选项2

区块引用中使用列表

1. 选项1
2. 选项2

五、代码块

1、单行代码块

使用 ` 包裹文本。

语法示例：

`test`

展示效果：

test

2、多行代码块

• 方式一，使用 4 个空格或者一个制表符（Tab 键）
  • 注意：代码块之前的一行不能有内容
• 方式二，使用三个及以上的 ` 包裹文本
  • 可以指定代码语言类型，有语法高亮

语法示例：

```
// 不指定代码语言
public class Demo{}
```

```java
// 指定代码语言，会有语法高亮
public class Demo{}
```

效果展示：

// 不指定代码语言
public class Demo{}

// 指定代码语言，会有语法高亮
public class Demo{}

六、链接

语法示例：

普通链接：会跳转搜狗  
[百度一下](www.sogo.com) 

高级链接：会跳转百度  
[百度一下]

[百度一下]: www.baidu.com

效果展示：

普通链接：会跳转搜狗
百度一下

高级链接：这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值（网址）

七、图片(未写完)

1、使用 Markdown 原生语法

语法示例：

![alt 属性文本](图片地址 "可选标题")

效果展示：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cvK5Pmlq-1629129869205)(www.无效.com)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Es8dpK2X-1629129869207)( https://www.runoob.com/wp-content/uploads/2019/03/iconfinder_markdown_298823.png “markdown图标”)]

2、使用 HTML img 标签

语法示例：

<img src="图片路径" alt="图片加载错误" width="30%" />

3、使用变量展示图片（与链接用法类似）

语法示例：

这个链接用 1 作为网址变量 [Markdown logo][1]。
然后在文档的结尾为变量赋值（网址）

[1]: https://www.runoob.com/wp-content/uploads/2019/03/iconfinder_markdown_298823.png

效果展示：

这个链接用 1 作为网址变量 Markdown logo。
然后在文档的结尾为变量赋值（网址）

八、表格

主要使用管道符 | 、英文冒号 : 、减号 - 进行标记， | 用于单元格隔断， : 和 - 放于第一行单元格下进行表头以及各列单元格内容位置的标识。

语法示例：

|    表头1   |    表头2    |    表头3   |   表头4    |
|------------|:----------:|:-----------|-----------:|
|   默认居左  |    居中    |    居左    |     居右    |

展示效果：

表头1	表头2	表头3	表头4
默认居左	居中	居左	居右

---

1. 这是脚注内容 ↩︎