bg1 bg2 bg3 bg6 bg7 bg8 bg9 bg10 bg11 bg12 bg13
capsule cover
skip to content
Hangdn Logo Hangdn blog

Markdown语法从入门到实战

/ 12 min read

markdown

简介

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

基础语法

标题

示例：

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

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

普通文本

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

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

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

高亮文本

`被高亮的内容`

被高亮的内容

字体格式

*我是斜体*


**我是粗体**


***我是粗斜体***

我是斜体

我是粗体

我是粗斜体

段落&换行

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

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

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

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

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

我是第一行 我是第二行


我是第一行


我是第二行


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

我是第一行 我是第二行

我是第一行

我是第二行

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

引用

> 引用的内容

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

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

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

示例：

> 单行引用


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


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

单行引用

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

嵌套引用

嵌套引用

嵌套引用

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

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

列表

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

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

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

无序列表语法：

- 无序列表。
- 无序列表。
- 无序列表。
  • 无序列表。
  • 无序列表。
  • 无序列表。

列表嵌套：

- 第一层列表
    - 第二层列表
        - 第三层列表
  • 第一层列表
    • 第二层列表
      • 第三层列表

• 缩进使用Tab键。

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

示例：

- 我是第一层列表
    - 我是第二层列表
        - 我是第三层列表
            - 我是第四层列表


- 我是第一层列表
    - 我是第二层列表
        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层列表

待办清单

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

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

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

注：x使用小写。

示例：

今日计划：
- [x] 吃
    - [x] 吃瓜
    - [ ] 吃鸡
- [x] 喝
- [ ] 玩
- [ ] 乐

今日计划：

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

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

分隔线

---

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

删除线 下划线

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

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

超链接

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

常用网站：知乎、B站

表格

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

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

• 表格对齐格式如下：

• 左对齐（默认）：:-

• 右对齐：-:

• 居中对齐：:-:

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

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

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

图片

语法：

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

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

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

需求：修改图片大小。

例如：<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 语法可派上用场。

例如：

例如：

图片

代码块

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

print('Hi,Markdown')

python print(‘Hi,Markdown’)

上标 下标

X^2^
H~2~O

X^2^ H2O

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

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

<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> 带背景的圆点

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

![描述](https://touchuan.2035.dpdns.org/file/1752914667683_195.jpg =600x400)

描述

引用链接

常用网站：[知乎]、[B站]


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

常用网站：知乎、B站

转义字符

语法：\特殊符号

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

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

脚注

语法

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

示例：

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

作者老王1 作者老七2

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

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


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

这是一个带脚注的句子3，另一个带自定义标签的脚注4。

缩进

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

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

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

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

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

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

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

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

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

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

频道：https://www.youtube.com/@kekelove1688 ✅🎁新人YouTube频道。

脚注：

  1. 这里是作者a ↩

  2. 这里是作者b ↩

  3. 这是第一个脚注的内容（自动编号）。 ↩

  4. 这是自定义标签的脚注内容，支持粗体等格式。 ↩

评论