Markdown语法从入门到实战

简介

    Markdown 是一种轻量级标记语言，用于使用纯文本编辑器创建格式化文本。其设计灵感主要来源于纯文本电子邮件的格式。目标是让人们能够使用易读、易写的纯文本格式编写文档，且可转换为 HTML。它是由一些简单的符号组成的用于排版的标记语言，其最重要的特点就是可读性强。美国人 约翰·格鲁伯（John Gruber） 于 2004 年创建了 Markdown。

基础语法

标题

示例：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

普通文本

注：直接输入，不添加任何标记就是普通文本。

1
我就是普通文本,无任何添加标记

我就是普通文本,无任何添加标记

高亮文本

1
`被高亮的内容`

被高亮的内容

字体格式

1
2
3
4
5
*我是斜体*

**我是粗体**

***我是粗斜体***

我是斜体

我是粗体

我是粗斜体

段落&换行

Markdown 中的段落由一行或多行文本组成，不同的段落之间使用空行来标记。

• 如果行与行之间无空行，则会被视为同一段落。

• 如果行与行之间有空行，则会被视为不同段落。

• 空行是指行内什么都没有。

• 如果想在段内换行，则需要在上一行的结尾插入两个以上的空格然后按回车键。

1
2
3
4
5
6
7
我是第一行 我是第二行

我是第一行

我是第二行

我是第一行，如果想段内换行，需在上一行结尾插入两个以上的空格然后回车 我是第二行

我是第一行 我是第二行

我是第一行

我是第二行

我是第一行，如果想段内换行，需在上一行结尾插入两个以上的空格然后回车 我是第二行

引用

1
> 引用的内容

• 在引用中可以嵌套引用。

• 在引用中可以使用其他的 Markdown 语法。

• 段落与换行的格式在引用中也是适用的。

示例：

1
2
3
4
5
6
7
8
9
10
11
12
> 单行引用

> 多行引用的第一行，我的最后有两个空格。  
多行引用的第二行，我的最后有两个空格。  
多行引用的第三行，我的最后有两个空格。   
多行引用的第四行，我的最后有两个空格。   
多行引用的第五行，结束行，后面没有空格了。  

> 嵌套引用
>> 嵌套引用
>>> 嵌套引用
>>>> ... 嵌套的层次取决于 `>` 的个数

单行引用

多行引用的第一行，我的最后有两个空格。
多行引用的第二行，我的最后有两个空格。
多行引用的第三行，我的最后有两个空格。
多行引用的第四行，我的最后有两个空格。
多行引用的第五行，结束行，后面没有空格了。

嵌套引用

嵌套引用

嵌套引用

… 嵌套的层次取决于 > 的个数

注：嵌套引用建议不要超过三个层次。

列表

Markdown 支持有序列表和无序列表。

有序列表语法(数字序号 空格 列表内容)：

1
2
3
1. 有序列表。
2. 有序列表。
3. 有序列表。
  1. 有序列表。
  2. 有序列表。
  3. 有序列表。

无序列表语法：

1
2
3
- 无序列表。
- 无序列表。
- 无序列表。
  • 无序列表。
  • 无序列表。
  • 无序列表。

列表嵌套：

1
2
3
- 第一层列表
    - 第二层列表
        - 第三层列表
  • 第一层列表
    • 第二层列表
      • 第三层列表

• 缩进使用Tab键。

• 有序列表和无序列表也可互相嵌套。（虽然语法支持，但不建议这样使用，层次多了容易乱）

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
- 我是第一层列表
    - 我是第二层列表
        - 我是第三层列表
            - 我是第四层列表

- 我是第一层列表
    - 我是第二层列表
        1. 我是第2.1层列表
            1. 我是第2.1.1层列表
            2. 我是第2.1.2层列表
        2. 我是第2.2层列表
            1. 我是第2.2.1层列表
            2. 我是第2.2.2层列表

  • 我是第一层列表

    • 我是第二层列表
      • 我是第三层列表
        • 我是第四层列表

  • 我是第一层列表

    • 我是第二层列表
      1. 我是第2.1层列表
        1. 我是第2.1.1层列表
        2. 我是第2.1.2层列表
      2. 我是第2.2层列表
        1. 我是第2.2.1层列表
        2. 我是第2.2.2层列表

待办清单

1
2
- [ ] 未勾选
- [x] 已勾选
  • 未勾选
  • 已勾选

• 当中括号中的字符为空格时，复选框是未选中状态。

• 当中括号中的字符为x时，复选框是已选中状态。

注：x使用小写。

示例：

1
2
3
4
5
6
7
今日计划：
- [x] 吃
    - [x] 吃瓜
    - [ ] 吃鸡
- [x] 喝
- [ ] 玩
- [ ] 乐

今日计划：

  • 吃
    • 吃瓜
    • 吃鸡
  • 喝
  • 玩
  • 乐

    注：任务列表是可以嵌套的。

分隔线

1
---

注：分隔线须使用至少3个以上的-来标记。

删除线 下划线

1
2
~~我是被删除的内容~~
<u>我是被下画线的文本内容</u>

我是被删除的内容
我是被下画线的文本内容

超链接

1
常用网站：[知乎](https://www.zhihu.com/)、[B站](https://www.bilibili.com/)

常用网站：知乎、B站

表格

• 在每一行最前和最后都使用|，每一行中的|要尽量都对齐。

• 表头与其他行使用-来分隔。

• 表格对齐格式如下：

• 左对齐（默认）：:-

• 右对齐：-:

• 居中对齐：:-:

• 块级元素（代码区块、引用区块）不能插入表格中。

• 不要使用庞大复杂的表格，那样会难以维护和阅读。
示例：

1
2
3
4
|左对齐|居中对齐|右对齐|
|:----|:----:|----:|
|01|知乎|https://www.zhihu.com|
|02|B站|https://www.bilibili.com|
左对齐 居中对齐 右对齐
01 知乎 https://www.zhihu.com
02 B站 https://www.bilibili.com 
1
2
3
4
|序号|网站|网址|
|----|----|----|
|01|知乎|https://www.zhihu.com|
|02|B站|https://www.bilibili.com|
序号 网站 网址
01 知乎 https://www.zhihu.com
02 B站 https://www.bilibili.com

图片

语法：

1
![图片替换文字](图片地址)

• 图片替代文字在图片无法正常显示时会比较有用，一般情况下可为空。
• 图片地址可以是本地图片路径也可以是网络图片路径。
• 本地图片支持相对路径和绝对路径两种方式。

1
2
3
![Yashiro](D:/images/Yashiro.jpg)
![Yashiro](D:/images/Yashiro_xxx.jpg)
![Yashiro](https://touchuan.2035.dpdns.org/file/1752914667683_195.jpg)

Yashiro
Yashiro
Yashiro

需求：修改图片大小。

1
2
3
例如：<img src="D:/images/Yashiro.jpg" width="100" height="100" />

例如：<img src="https://touchuan.2035.dpdns.org/file/1752914667683_195.jpg" width="200" height="200" />

Markdown 默认没有修改图片大小的语法。但其本身相当于简化版的 HTML，此时 HTML 语法可派上用场。

例如：

例如：

代码块

用三个`包裹 代码 ，例如：

1
print('Hi,Markdown')

python
print(‘Hi,Markdown’)

上标 下标

1
2
X^2^
H~2~O

X^2^
H2O

1
水的化学式是H<sub>2</sub>O，而面积单位是m<sup>2</sup>。

水的化学式是H2O，而面积单位是m2。

1
2
3
<span style="color: blue; font-size: 1.2em;">•</span> 蓝色圆点
<span style="color: red;">▶</span> 红色箭头
<span style="background: #f0f0f0; padding: 2px 6px; border-radius: 3px;">⦿</span> 带背景的圆点

• 蓝色圆点
▶ 红色箭头
⦿ 带背景的圆点

引用链接

1
2
3
4
常用网站：[知乎]、[B站]

[知乎]:https://www.zhihu.com/
[B站]:https://www.bilibili.com/

常用网站：知乎、B站

转义字符

语法：\特殊符号

1
2
3
4
5
6
7
8
9
10
11
12
\\ 反斜杠  
\` 反引号  
\* 星号  
\_ 底线  
\{} 大括号  
\[] 中括号  
\() 小括号  
\# 井字号  
\+ 加号  
\- 减号  
\. 英文句号  
\! 英文叹号

\ 反斜杠
` 反引号
* 星号
_ 底线
{} 大括号
[] 中括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句号
! 英文叹号

脚注

语法

1
2
3
4
脚注1[^1]
脚注2[^2]
[^1]:这里是脚注1
[^2]:这里是脚注2

示例：

1
2
3
4
作者a[^1]
作者b[^2]
[^1]:这里是作者a
[^2]:这里是作者b

作者老王^5
作者老七^6

注：
• 脚注 id 必须唯一。
• 无论脚注 id 如何起名，显示时一律标为数字，并且按出现顺序排列。

1
2
3
4
这是一个带脚注的句子[^1]，另一个带自定义标签的脚注[^note]。

[^1]: 这是第一个脚注的内容（自动编号）。
[^note]: 这是自定义标签的脚注内容，支持**粗体**等格式。

这是一个带脚注的句子^1，另一个带自定义标签的脚注^note。

缩进

1
2
3
&nbsp;四分之一个字符缩进
&ensp;二分之一个字符缩进
&emsp;一个字符缩进

效果如下：
 四分之一个字符缩进
 二分之一个字符缩进
 一个字符缩进

首行缩进可以连用来显示：

使用4个&ensp;或2nbsp;缩进2个汉字大小。

使用2个&emsp;缩进2个字符。

1
&ensp;&ensp;&ensp;&ensp;企业文化宣传,智能家居制造企业的诗句，融合了科技感、制造业氛围和智慧生活。

    企业文化宣传,智能家居制造企业的诗句，融合了科技感、制造业氛围和智慧生活。

🤖 欢迎来到我的 GitHub 仓库！ 🚀

🐟️ 我是一位热爱技术的小白。我在Github学习开源项目，在日常生活中应用各种项目。

🎉 感谢你的到访，希望你在这里能找到你需要的东西！

▶️新人Youtuber，需要您的支持，请务必帮我点赞、关注、打开小铃铛，十分感谢！！！ ✅🎁

[up主专用，视频内嵌代码贴在这]