Markdown入门与语法汇总

Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用。

Markdown 和常见的富文本编辑器有什么区别

如果只输入不带任何格式的文字，无需任何复杂的工具。正是为了赋予文字不同的「外貌」（即格式或者样式），我们才需要文字编辑器。例如输入的文字属于纯文本（即不带格式），而给文字标记上的颜色则属于文字的样式。对于用户来说，Markdown 编辑器和富文本编辑器（例如 Word )的作用是一致的：使用者输入纯文字，通过编辑器的处理，使其拥有一份样式，最终得到带格式的文档。

然而这两者的差距，就在处理文字的过程中。富文本编辑器以 Word 为例，输入文字后，选择不同的功能（通常是通过点击某个图标），例如加粗或者调整字体大小，处理后的效果直接显示在屏幕上，与打印出来的效果相同。所以富文本编辑器又叫「所见即所得」编辑器。

而 Markdown 编辑器则不同，输入文字后通常是在文字的前后同时输入一些标记字符对文字添加样式，例如加粗文字在 Markdown 种是在文本前后添加两个星号。输入后在编辑窗口也不会即时的显示出效果 ，需要手动切换进预览模式查看处理效果。因为这些标记字符的存在，所以 Markdown 本身是一种标记语言。

markdown编辑器

1.网页在线markdown编辑器
https://markdown.lovejade.cn/
https://www.toolhelper.cn/Code/Markdown

一些博客网站也提供在线markdown编辑器，例如cnblog等，你可以直接在这些在线markdown编辑器中输入并看到展示的结果。

2.markdown编辑器应用
使用markdown编辑器应用可以使用更丰富的功能，各个平台的推荐markdown编辑器应用如下：

• iOS/macOS : Bear
• Windows：Typora
• Android：易写

Markdown语法

标题

使用不同个数#可以生成不同层级的标题

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

对应的展示结果如下

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

目录

基本上面说的标题可以在文章中自动生成目录，语法为：

@[TOC](这里写自定义目录标题)

这一个语法在有些markdown版本中是支持的，有些基础版本并不支持

文本的样式

*斜体文本* ：在需要斜体的文本前后各加一个*号**加粗文本** ：在需要加粗的文本前后各加2个*号***加粗斜体文本***：同时加粗和斜体在文本前后各加3个*号==标记文本==：在文本前后加两个=可以高亮文本~~删除文本~~：在文本前后加两个~可以在文本中添加横线表示被删除的文本> 引用文本：用独特的格式展示文本H~2~O is是液体。：前后加上~可使文本以下标显示2^10^ 运算结果是 1024.：前后加上^可使文本以下标显示

上面的文本在经过Markdown渲染后的展示如下：
斜体文本

加粗文本

加粗斜体文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

插入链接的格式为[展示的名称][链接],展示的名称可以任意修改。例如要添加一个bing主页的链接

[必应主页](https://cn.bing.com/)

必应主页.

插入图片:

插入图片的基础格式为

![在这里插入图片描述](在这里插入图片链接)

输入如下代码可以生成图片：

![图片](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw)

同时可以在链接后加入格式控制代码对图片进行调整

带尺寸的图片: 链接后输入  =尺寸
![图片](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw =30x30)居中的图片:链接后输入 #pic_center
![图片](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw#pic_center)居中并且带尺寸的图片:上述两个代码都加上![图片](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw#pic_center =30x30)

如何插入代码片

使用三个反引号`(即键盘左上角的波浪号那个键)可以添加一段文本或者代码快，同时在后面可以加上对应的语言名称，可以展示高亮的代码块，使代码更美观更易读

例如如下代码

渲染后的结果为

// An highlighted block
var foo = 'bar';

高亮python，c等代码同理。

列表

1.有序列表

使用数字后加.加空格即可生成一个带数字的列表

1.第一个元素（记住.后面得按一个空格键）
2.第二个元素

需要注意的是markdown会自动对列表数字排序，所以前面的数字可以比较随意的填写。输入如下两段：

1. 项目1
2. 项目2
3. 项目3
或：
1. 项目1
1. 项目2
1. 项目3

得到的展示结果如下：

1. 项目1
2. 项目2
3. 项目3

2.无序列表

+或者-后添加对应的元素
注意：连续按两个回车键，则是中断

利用如下文本创建一个列表

- 项目
- 项目
- 项目+ 1
+ 2
+ 3

• 项目
• 项目
• 项目

• 1
• 2
• 3

3. 列表层级

序号后面按“tab"键或者连着输入两个空格即可缩进列表，从而能展示出列表的层级

- 项目- 项目- 项目

• 项目
  • 项目
    • 项目

4.勾选框

使用如下语法可以添加一个勾选框：

- [ ]  一个空白的勾选框
- [x]  一个打上勾的的勾选框

• 计划任务
• 完成任务

创建一个表格

一个简单的表格语法如下：

| 标题列  | 标题列 |
| ------------- | ------------- |
| 单元格内容  | 单元格内容  |
| 单元格内容  | 单元格内容  |

其中|用来作为列分隔，需要几行几列的数据就可以自行添加对应的分隔元素。
接下列创建一个四行三列的表格：

物品     | 价格|销量
-------- | -----|-----
电脑  | $1600|593
手机  | $12|355
电线  | $1|1024

渲染后生成如下表格：

物品	价格	销量
电脑	$1600	593
手机	$12	355
电线	$1	1024

可以使用一些网页工具将表格快捷的转为markdown格式，链接如下：
https://tableconvert.com/

设定表格内容位置

使用冒号:控制表格内容的位置
使用:---------:居中
使用:----------居左
使用----------:居右

| 第一列       | 第二列         | 第三列        |
|:-----------:| -------------:|:-------------|
| 第一列文本居中 | 第二列文本居右  | 第三列文本居左 |

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

注脚

[^数字]可以给文本中添加一个上标表示有注释，并在文章的最后添加注脚对其进行解释
创建注脚的例子如下，其中第二行对注脚的解释在文章的最末尾你才能看到

一个具有注脚的文本。[^2][^2]: 注脚的解释

渲染后结果：
一个具有注脚的文本。¹

注释

*[文本]: 这里写注释可以添加注释，当鼠标放到注释的文字位置上时就会出现注释。需要注意在正文中文本需要在前面加一个空格，且文本保持一致

举个例子如下：

Markdown将文本转换为 HTML。*[HTML]:   超文本标记语言

Markdown将文本转换为 HTML。

数学公式

可以使用LaTeX渲染数学表达式，使用$包裹与对应语法即可生成数学公式，具体可参阅：https://blog.csdn.net/qq_42692386/article/details/137540972

例如使用如下代码生成一个数学公式：

$f(x)=e^x+5x$

$f(x)=e^x+5x$

---

1. 注脚的解释 ↩︎