史上最全最详细的 Markdown 基础语法 | 通俗易懂
目录
- 1、Markdown 简介
- 2、Markdown 标题
- 这里是一级标题
- 这里是二级标题
- 现在向您走来的是一级标题
- 现在向您走来的是二级标题
- 现在向您走来的是三级标题
- 现在向您走来的是四级标题
- 现在向您走来的是五级标题
- 现在向您走来的是六级标题
- 3、Markdown 段落
- 文本样式
- 下标和上标
- 标记文本
- 分割线
- 删除线
- 下划线
- 注脚
- 注释
- 4、Markdown 列表
- 无序列表
- 有序列表
- 列表嵌套
- 计划任务
- 5、Markdown 区块
- 区块的嵌套
- 区块中使用列表
- 列表中使用区块
- 6、Markdown 代码
- 代码块
- 7、Markdown 链接
- 高级链接
- 8、Markdown 图片
- 9、Markdown 表格
- 10、Markdown 高级技巧
1、Markdown 简介
Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为（.md）或（.markdown）。
2、Markdown 标题
Markdown 标题的表示方法有两种格式。
- 使用等号（=）表示一级标题，使用减号（-）表示二级标题。
示例：
这里是一级标题
=
这里是二级标题
-
效果预览：
这里是一级标题
这里是二级标题
- 使用井号（#）号可表示 1-6 级标题，一级标题对应一个井号（#）号，二级标题对应两个井号（##），以此类推。
示例：
# 现在向您走来的是一级标题
## 现在向您走来的是二级标题
### 现在向您走来的是三级标题
#### 现在向您走来的是四级标题
##### 现在向您走来的是五级标题
###### 现在向您走来的是六级标题
效果展示：
现在向您走来的是一级标题
现在向您走来的是二级标题
现在向您走来的是三级标题
现在向您走来的是四级标题
现在向您走来的是五级标题
现在向您走来的是六级标题
3、Markdown 段落
文本样式
Markdown 可以使用以下几种字体：
- 斜体文本
- 一对星号（*）或底线（_），中间加上需要倾斜的文字。
- 粗体文本
- 两对星号（** **）或底线（__ __），中间加上需要加粗的文字。
- 粗斜体文本
- 三对星号（*** ***）或底线（___ ___），中间加上需要加粗和倾斜的文字。
示例：
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
效果预览：
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
下标和上标
下标使用一对波浪线（~）表示，上标使用（^^）表示。
下标示例：
水的化学式是 H~2~O
效果预览：
水的化学式是 H2O
上标示例：
2^10^次方为1024
效果预览：
210次方为1024
标记文本
使用四个等号（=）标记文本
==CSDN==
效果预览：
CSDN
分割线
在一行中用三个或三个以上的星号（***）、减号（—）、底线（___）来建立一个分隔线。1
示例：
***
---
___
效果预览：
删除线
如果要在文字上添加删除线，只需要在文字的两端加上两个波浪线（~~）即可。
示例：
~~我是一条删除线呀！~~
效果预览：
我是一条删除线呀！
下划线
下划线可以通过 HTML 的 标签来实现：
示例：
我是一条下划线呀
效果展示：
我是一条下划线呀
注脚
注脚是对文本的补充说明。
我是带有注脚的文本哦！[^注脚]。
[^脚注]：我是带有注脚的文本哦！
效果预览：
我是带有注脚的文本哦！2
注释
Markdown 将文本转换为 HTML 。
*[HTML]: 超文本标记语言
效果展示
Markdown 将文本转换为 HTML 。
4、Markdown 列表
Markdown 支持有序列表和无序列表。
无序列表
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容。
示例：
* 一只羊
* 两只羊
* 三只羊
- 一个饺子
- 两个饺子
- 三个饺子
+ 第一节
+ 第二节
+ 第三节
效果预览：
- 一只羊
- 两只羊
- 三只羊
- 一个饺子
- 两个饺子
- 三个饺子
- 第一节
- 第二节
- 第三节
有序列表
有序列表使用数字加上点号（.）然后加上空格来表示。
示例：
1. 一只羊
2. 两只羊
3. 三只羊
效果预览：
- 一只羊
- 两只羊
- 三只羊
列表嵌套
列表嵌套只需在子列表中的选项前面添加四个空格或一个Tab即可。
示例：
1. 第一章：
1. 第一节
2. 第二节
3. 第三节
2. 第二章：
1. 第一节
2. 第二节
3. 第三节
- 第一章
- 第一节
- 第二节
- 第三节
- 第二章
1. 第一节
2. 第二节
3. 第三节
- 第一章
1. 第一节
2. 第二节
3. 第三节
- 第二章
1. 第一节
2. 第二节
3. 第三节
效果预览：
- 第一章：
- 第一节
- 第二节
- 第三节
- 第二章：
- 第一节
- 第二节
- 第三节
-
第一章
- 第一节
- 第二节
- 第三节
-
第二章
- 第一节
- 第二节
- 第三节
-
第一章
- 第一节
- 第二节
- 第三节
-
第二章
- 第一节
- 第二节
- 第三节
计划任务
示例：
- [ ] 计划任务
- [x] 完成任务
效果预览：
- 计划任务
- 完成任务
5、Markdown 区块
Markdown 区块引用是在段落开头使用大于号（>），然后后面紧跟一个空格符号。
示例：
> 区块1
> 区块2
> 区块3
效果展示：
区块1
区块2
区块3
区块的嵌套
示例：
> 最外层
>> 第一层嵌套
>>> 第二层嵌套
效果预览：
最外层
第一层嵌套
第二层嵌套
区块中使用列表
示例：
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
效果预览：
区块中使用列表
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
列表中使用区块
如果要在列表项目内放进区块，那么就需要在大于号（>）前添加四个空格的缩进。
示例：
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
效果预览：
- 第一项
巴拉巴拉
巴拉巴拉一堆 - 第二项
巴拉巴拉
巴拉巴拉一堆
6、Markdown 代码
如果是段落上的一个函数或片段的代码可以用一对反引号（`）把它包起来。
示例：
`main()`函数
效果预览：
程序从main()函数开始。
代码块
可以用三对反引号（``````）包裹一段代码，并指定一种语言（也可以不指定）。
示例：
```Java
public class HelloWorld{
public static void main(String[] args){
System.out.println("Hello World!");
}
}
```
效果预览：
public class HelloWorld{
public static void main(String[] args){
System.out.println("Hello World!");
}
}
7、Markdown 链接
链接的使用方法：
[链接名称](链接地址)
或者
<链接地址>
示例：
这是一个链接：[百度一下，你就知道](https://www.baidu.com)
效果预览：
这是一个链接：百度一下，你就知道
https://www.baidu.com
高级链接
可以通过变量来设置一个链接，变量赋值在文档末尾进行。
示例：
这个链接用 3 作为网址变量 [百度一下，你就知道][3]
这个链接用 runoob 作为网址变量 [baidu][baidu]
然后在文档的结尾为变量赋值（变量的值为网址）
[3]: https://www.baidu.com
[baidu]: https://www.baidu.com
效果预览：
这个链接用 3 作为网址变量 百度一下，你就知道
这个链接用 runoob 作为网址变量 baidu
然后在文档的结尾为变量赋值（变量的值为网址）
8、Markdown 图片
参考CSDN帮助文档
图片:
效果预览：
图片:
带尺寸的图片:
效果预览：
带尺寸的图片:
居中的图片:
效果预览：
居中的图片:
居中并且带尺寸的图片:
效果预览：
居中并且带尺寸的图片:
9、Markdown 表格
Markdown 制作表格使用（|）来分隔不同的单元格，使用（-）来分隔表头和其他行。
语法格式如下：
| 表头 | 表头 |
| - | - |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
效果预览：
| 表头 | 表头 |
|---|---|
| 单元格 | 单元格 |
| 单元格 | 单元格 |
设置表格的对齐方式
-: 设置内容和标题栏向右对齐。
:- 设置内容和标题栏向左对齐。
:-: 设置内容和标题栏居中对齐。
示例：
| 左对齐 | 右对齐 | 居中对齐 |
| :- | -: | :-: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果预览：
| 左对齐 | 右对齐 | 居中对齐 |
|---|---|---|
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
10、Markdown 高级技巧
支持HTML元素
-
不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
-
目前支持的 HTML 元素有：
等。
使用 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制
使用 Ctrl + C 复制
你也可以在星号、减号、底线中间插入空格，除了空格行内不能有其他东西。 ↩︎
我是带有注脚的文本哦！ ↩︎