Markdown基础语法

呆呆的猪胖胖 Lv4

前言

这个博客构成内容最多的几乎就是Markdown文件了,但是我竟然截止到目前,没有写一篇关于Markdown语法介绍的文章,今天特意补上。

语法

注释

Markdown的注释采用html的注释样式,使用下面的方式进行注释:

1
<!-- 这是一个Markdown注释 -->

标题

标题的书写方式是#加空格加文字,几个#就代表几级标题。
例如,如下的代码:

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

渲染之后的代码如下所示:

一级标题

二级标题

三级标题

四级标题

五级标题

特殊样式

斜体

斜体使用在文字的两侧增加一个*_实现
如下列的代码:

1
2
*斜体*
_斜体_

渲染的效果为:
斜体
斜体

粗体

粗体很简单,就是增加两个*_就可以了
如下列的代码:

1
2
**粗体**
__粗体__

渲染的效果为:
粗体
粗体

粗斜体

粗斜体就是增加三个。
如下列的代码:

1
2
***粗斜体***
___粗斜体___

渲染的效果为:

粗斜体
粗斜体

删除体

如果要在文本中间增加一条删除线,则需要在文本的两端增加两个~
如下列的代码:

1
~~删除体~~

渲染的效果如下:
删除体

下划体

如果要在文本下方增加下划线,则需要使用类似html的书写方式。在文本左侧增加<u>右侧则为</u>
例如下列的代码

1
<u>下划体</u>

渲染的效果:
下划体

脚注

如果要增加脚注,需要使用[^]来产生。
例如下列的代码:

1
2
3
正文[^脚注]

[^脚注]: 脚注的内容

显示的效果如下:

正文^脚注

列表

列表分为无序和有序两种。

无序列表

无序列表在前方使用*-+来标识,空格之后跟条目内容,如果想要确定列表的深度,就需要在前方增加缩进。
例如,如下的代码:

1
2
3
4
5
6
* 条目
- 条目
- 条目
- 条目
- 条目
* 条目

渲染后的结果如下:

  • 条目
    • 条目
    • 条目
      • 条目
        • 条目
  • 条目

有序列表

与无序列表的差别就是,有序列表使用number.这样来标识条目。
例如,如下的代码:

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

渲染之后的效果如下所示:

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

表格

表格使用|来分割表格的列,使用-来分割表头和其他的行。
例如,如下的代码:

1
2
3
4
|条目|条目|
|-|-|
|奇数行|奇数行|
|偶数行|偶数行|

实现的效果:

条目条目
奇数行奇数行
偶数行偶数行

此外,还可以使用:来设置表格的对齐方式。
例如,如下的代码:

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

渲染的效果:

左对齐右对齐居中对齐
单元格单元格单元格
单元格单元格单元格

引用

引用使用>来进行标识,只要在文本前增加一个>符号,该段文字就会自动变为引用文字。
例如,如下的代码:

1
> 引用的文字

展示的效果如下所示:

引用的文字

Warn

使用引用的时候,请注意在引用符号这一段结束之后,务必增加一个空行,否则接下来的正文可能会被识别为引用的文字。
例如

1
2
3
<!--错误示范-->
> 引用文字
紧跟着引用的正文

渲染的效果如下:

引用文字
紧跟着引用的正文

正确的做法应当是:

1
2
3
4
<!--正确示范-->
> 引用文字

紧跟着引用的正文

渲染的效果如下:

引用文字

紧跟着引用的正文

代码

代码分为行内代码和行间代码。

行内代码

使用行内代码,需要使用 ` 号将代码包围。
如下列代码:

1
`code`

显示的效果为

code

行间代码

行间代码有两种方式分别是使用三个 ` 或者~来进行包围。
例如下列代码:

```

code

```

显示的效果为

1
code

~~~

code

~~~

显示的效果为:

1
code

Note

这里的源码暂时没有找到合适的方式,暂时先保持这个样子,以后找到解决方式再回来修改

链接

链接的使用方式为:[显示文字](链接地址)或者为<链接地址>
如以下的源代码:

1
2
3
[我的博客](https://blog.cflmy.cn/)

<https://blog.cflmy.cn/>

显示的效果如下所示:

我的博客

https://blog.cflmy.cn/

进阶配置

使用链接还有一种方式,非常类似于脚注。
例如下列代码:

1
2
3
[我的博客][链接1]

[链接1]: https://blog.cflmy.cn/

显示的效果为:
我的博客

此外,插入图片和插入链接十分类似,使用方式为![显示失败出现的文字](图片地址)
例如下列代码:

1
![](../../../img/mascot.webp)

显示效果为:

分割线

使用三个-可以制造一条分割线。
例如下列代码:

1
---

显示的效果为:


后记

以上就是Markdown的基本语法,后续发现有遗漏的或许会再行补充。


同系列:

Markdown基础语法
Latex基础语法
Typst-基础使用

  • Title: Markdown基础语法
  • Author: 呆呆的猪胖胖
  • Created at : 2025-03-19 10:30:00
  • Updated at : 2025-05-13 15:34:43
  • Link: https://blog.cflmy.cn/2025/03/19/Technology/Markdown/Markdown/
  • License: This work is licensed under CC BY-NC-SA 4.0.
Comments