Markdown的简单使用

最新推荐文章于 2025-11-29 15:42:10 发布

原创最新推荐文章于 2025-11-29 15:42:10 发布 · 1.1k 阅读

29 ·

CC 4.0 BY-SA版权

文章标签：

#笔记

与其临渊羡鱼，不如退而结网。

文章目录

前言
一、标题和目录
- 1.1 标题
- 1.2 目录
二、斜体与粗体
- 2.1 斜体
- 2.2 粗体
- 2.3 粗斜体和斜粗体
- 2.4 斜体中包含粗体
- 2.5 粗体中包含斜体
三、线
- 3.1 分割线
- 3.2 删除线
- 3.3 下划线
四、列表和引用
- 4.1 有序列表
- 4.2 无序列表
- 4.3 引用
- 4.4 缩进&退格
五、注释&转义字符&空格&换行
- 5.1 注释
- 5.2 转义字符
- 5.3 空格
- 5.4 换行
六、表格
七、代码域
- 7.1 行内代码
- 7.2 代码块
- 7.3 代码块的嵌套
八、待办任务
九、网页与图像
- 9.1 网页
- 9.2 图像
十、变量
- 10.1 网络链接变量
- 10.2 脚注变量
十一、扩展文本显示效果
- 11.1 支持HTML标签
- 11.2 文本高亮
- 11.3 上标
- 11.4 下标
- 11.5 表情符号
十二、数学公式
- 12.1 行内公式
- 12.2 公式块
十三、嵌入
- 13.1 嵌入音频
- 13.2 嵌入视频
十四、支持各种图
结束语

前言

经济下行，行业竞争愈发激烈，同行间也越来越卷。只有不断地学习，提升自己的综合能力，才不会被淘汰，所以提升学习效率是非常重要的。
我们可以看官方文档、看B站视频，看书，但是总会看了就忘，忘了再看，总是记不住。只有对原理有深刻的理解，以及不断地重复记忆和实践，才能彻底掌握一门知识。
记笔记是一个非常好的习惯，记笔记不仅可以梳理自己的思路，并且可以在反复修改笔记的过程中，让我们注意到一些容易忽略的细节。与此同时，当我们忘记了某知识点时，我们可以随时翻看笔记，从而快速捡起那些被遗忘的知识点。
记笔记需要好的工具，可以借助一些在线网站或笔记软件，它们很多都支持Markdown，本文档本着学习Markdown的目的，跟大家一起分享下Markdown的基本用法。

1、什么是Markdown？
  答：Markdown 是一款轻量级标记语言，与HTML不同，它的语法非常简单；
2、为什么要使用Markdown？
  1. Markdown非常简洁和精炼，对比其他工具，它可以让我们远离臃肿的功能，让我们回归内容本身；
  2. Markdown以纯文本格式编写文档，依赖键盘而非鼠标，可以让我们专注于写作本身，而非文档格式；
  3. Markdown是笔记与网页文章的最佳载体，市面上有很多支持MD的在线编辑网页和笔记软件。

注意：本文章中，Markdown中用到的符号都是英文状态下的符号。

一、标题和目录

1.1 标题

标题：一个或多个# + 空格 + 文本

注意事项：一个#代表一级，最多支持六级标题，即一级标题~六级标题。
示范写法：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示效果：

1.2 目录

目录：在文档的顶部输入[toc]，会根据1.1所述的标题自动生成文章目录

注意事项：并不是所有的MD编辑器都支持自动生成文章目录
示范写法： [toc]
显示效果：见本文档的文章目录

二、斜体与粗体

2.1 斜体

斜体写法一：* + 文本 + *

示范写法：*这是斜体文本*
显示效果：这是斜体文本

斜体写法二：_ + 文本+ _

示范写法：_这也是斜体文本_
显示效果：这也是斜体文本

2.2 粗体

粗体写法一：** + 文本 + **

示范写法：**这是粗体文本**
显示效果：这是粗体文本

粗体写法二：__ + 文本 + __

格式说明：__是由两个下划线_组成的
示范写法：__这也是粗体文本__
显示效果：这也是粗体文本

2.3 粗斜体和斜粗体

粗斜体和斜粗体：粗体和斜体相互嵌套，一共有六种

示范写法：
***粗斜体1***
**_粗斜体2_**
*__粗斜体3__*
___粗斜体4___
__*粗斜体5*__
_**粗斜体6**_
显示效果：
粗斜体1
粗斜体2
粗斜体3
粗斜体4
粗斜体5
粗斜体6

2.4 斜体中包含粗体

说明：
- 斜体中包含粗体，外面是斜体，里面是粗体，为嵌套关系
- 外面是斜体，标识符是一个；里面是粗体，标识符是两个
- 里面的粗体，符号不能是两个下划线__，否则没效果
格式一： * + 文本 + ** + 粗体文本 + ** + 文本 + *
示范写法：*君不见**黄河之水**天上来*
显示效果：君不见黄河之水天上来
格式二： _ + 文本 + **+ 粗体文本 + ** + 文本 + _
示范写法：_君不见**黄河之水**天上来_
显示效果：君不见黄河之水天上来

2.5 粗体中包含斜体

说明：
- 粗体中包含斜体，外面是粗体，里面是斜体，为嵌套关系
- 外面是粗体，标识符是两个，里面是斜体，标识符是一个
- 里面的斜体，符号不能是一个下划线_，否则没效果
格式一：** + 文本 + * + 斜体文本 + * + 文本 + **
示范写法：**君不见*黄河之水*天上来**
显示效果：君不见黄河之水天上来
格式二：__ + 文本 + * + 斜体文本 + * + 文本 + __
格式说明：__是由两个下划线_组成
示范写法：__君不见*黄河之水*天上来__
显示效果：君不见黄河之水天上来

三、线

3.1 分割线

分割线写法一：***

示范写法：***
显示效果：

分割线写法二：---

示范写法：---
显示效果

3.2 删除线

删除线： ~~ + 文本 + ~~

示范写法：~~这是删除线~~
显示效果：~~这是删除线~~

3.3 下划线

下划线： + 文本 + 

示范写法：这是下划线
显示效果：这是下划线

四、列表和引用

4.1 有序列表

有序列表：阿拉伯数字 + . + 空格 + 文本

格式说明：
- 空格不能丢
- 渲染界面会强制顺序显示，它的序号是逐一递进的，编辑界面修改序号将不生效
示范写法：

1. 这是第一条数据（注意，点和文字之间有空格）
2. 这是第二条数据
3. 这是第三条数据
4. 这是第四条数据

显示效果：

这是第一条数据
这是第二条数据
这是第三条数据
这是第四条数据

4.2 无序列表

无序列表：- + 空格 + 文本

说明：+和*可以替换-
示范写法：

- 这是第一个无序列表
- 这是第二个无序列表
- 这是第三个无序列表
- 这是第四个无序列表

显示效果：

这是第一个无序列表
这是第二个无序列表
这是第三个无序列表
这是第四个无序列表

4.3 引用

引用：> + 文本

格式说明：
- 同一个段落内的引用换行时，直接敲一次回车键即可
- 如果需要使用第二个独立段落引用，在换行后，再敲两次回车键，留出空行
示范写法： >这里是引用内容
显示效果：

这里是引用内容

4.4 缩进&退格

缩进：使用Tab键
退格：使用Shift键 + Tab键

说明：引用中使用两个或多个右尖括号>来缩进引用，如>>

五、注释&转义字符&空格&换行

5.1 注释

注释：

说明：注释用于对内容和功能进行解释说明，只在编辑界面可见，渲染界面不可见
示范写法：
显示效果：无

5.2 转义字符

转义字符： \ + 特殊字符

格式说明：反斜杠\的作用是用于转义特殊符号，将特殊符号作为字符本身呈现出来
举例说明：星号*在markdown里面可以用作斜体标识，但是我想显示星号*本身怎么办？那我们可以使用反斜杠\*，这样就可以显示星号*了。其他的特殊符号同理。

5.3 空格

空格： 

格式说明：使用多少次 ，就会产生多少个空格
示范写法：      123456
显示效果：
123456(前面有五个空格)

5.4 换行

换行： 

格式说明：有些MD编辑器，回车键换行没有效果，可以使用 换行

六、表格

格式说明：
- 【|】是构成表格的主要框架
- 【-】区分表头和表格主体
- 【:】可以设置文本对齐方式
 1. 【:-】代表左对齐
 2. 【:-:】代表居中对齐
 3. 【-:】代表右对齐
- 【 】单元格数据较多时，会撑开表格宽度，可以使用 换行
示范写法：

|表头一|表头二|表头三|
|:-|:-:|-:|
|单元格数据1|单元格数据2|单元格数据3|
|单元格数据4<br>单元格数据4的其余内容|单元格数据5|单元格数据6|

显示效果：

表头一	表头二	表头三
单元格数据1	单元格数据2	单元格数据3
单元格数据4 单元格数据4的其余内容	单元格数据5	单元格数据6

七、代码域

7.1 行内代码

行内代码：两个单反引号 + 文本 + 两个单反引号

格式说明：
- 只要屏幕够宽，否则行内代码能一直不换行
- 行内代码内不一定只用来写代码，也可以用来强调内容
示范写法： ``这里是行内代码``
显示效果：这里是行内代码

7.2 代码块

代码块写法一：在首行和末行各添加三个反引号，内容写在中间行

格式说明：
- 首行的符号后面可以添加语言种类
- 语言种类是可选项；
- 语言种类和代码内容之间需要有空格或换行
示范写法：
```java
public calss Test{
    public static void main(args:String[]){
        println(“Hello World”)
    }
}
```
显示效果：

public calss Test{
	public static void main(args:String[]){
		println("Hello World")
	}
}

代码块写法二：在首行和末行各添加三个波浪号，内容写在中间行

格式说明：
- 首行的符号后面可以添加语言种类
- 语言种类是可选项；
- 语言种类和代码内容之间需要有空格或换行
示范写法：
~~~kotlin
val list = listOf(1,2,3)
list.map{
“i=$it”
}.forEach{
printf(it)
}
~~~
显示效果：

val list = listOf(1,2,3)
list.map{
	"i=$it"
}.forEach{
	printf(it)
}

7.3 代码块的嵌套

代码块的嵌套写法一：使用四个单反引号嵌套三个单反引号
继续嵌套：使用五个单反引号嵌套四个单反引号，以此类推

八、待办任务

任务列表：- + 空格 + [ + 空格 + ] + 任务内容文本

格式说明：在中括号[ ]中填入英文字母x，在渲染界面，待办任务前面会显示对勾
示范写法：- [ ] 这里是任务内容
显示效果：
任务内容

九、网页与图像

9.1 网页

网页：[ + 链接描述 + ] + (+ 链接地址 + 空格 + "+ 额外信息文本 + "+ )

格式说明：
1. 链接描述：呈现给用户看的文本，用于对链接的说明
2. 额外信息文本：额外的提示信息，鼠标悬停时显示的文本，可选项
3. 链接地址和额外信息文本之间有空格
4. 额外信息文本需要用双引号包裹
示范写法：[百度一下，你就知道](http://www.baidu.com “额外的提示信息”)
显示效果：百度一下，你就知道