Markdown基础语法

前言
这个博客构成内容最多的几乎就是Markdown文件了,但是我竟然截止到目前,没有写一篇关于Markdown语法介绍的文章,今天特意补上。
语法
注释
Markdown的注释采用html的注释样式,使用下面的方式进行注释:
1 | <!-- 这是一个Markdown注释 --> |
标题
标题的书写方式是#
加空格加文字,几个#
就代表几级标题。
例如,如下的代码:
1 | # 一级标题 |
渲染之后的代码如下所示:
一级标题
二级标题
三级标题
四级标题
五级标题
特殊样式
斜体
斜体使用在文字的两侧增加一个*
或_
实现
如下列的代码:
1 | *斜体* |
渲染的效果为:
斜体
斜体
粗体
粗体很简单,就是增加两个*
或_
就可以了
如下列的代码:
1 | **粗体** |
渲染的效果为:
粗体
粗体
粗斜体
粗斜体就是增加三个。
如下列的代码:
1 | ***粗斜体*** |
渲染的效果为:
粗斜体
粗斜体
删除体
如果要在文本中间增加一条删除线,则需要在文本的两端增加两个~
。
如下列的代码:
1 | ~~删除体~~ |
渲染的效果如下:删除体
下划体
如果要在文本下方增加下划线,则需要使用类似html的书写方式。在文本左侧增加<u>
右侧则为</u>
例如下列的代码
1 | <u>下划体</u> |
渲染的效果:
下划体
脚注
如果要增加脚注,需要使用[^]
来产生。
例如下列的代码:
1 | 正文[^脚注] |
显示的效果如下:
正文^脚注
列表
列表分为无序和有序两种。
无序列表
无序列表在前方使用*
或-
或+
来标识,空格之后跟条目内容,如果想要确定列表的深度,就需要在前方增加缩进。
例如,如下的代码:
1 | * 条目 |
渲染后的结果如下:
- 条目
- 条目
- 条目
- 条目
- 条目
- 条目
- 条目
有序列表
与无序列表的差别就是,有序列表使用number.
这样来标识条目。
例如,如下的代码:
1 | 1. 有序列表 1 |
渲染之后的效果如下所示:
- 有序列表 1
- 有序列表 2
- 有序列表 3
- 有序列表 4
表格
表格使用|
来分割表格的列,使用-
来分割表头和其他的行。
例如,如下的代码:
1 | |条目|条目| |
实现的效果:
条目 | 条目 |
---|---|
奇数行 | 奇数行 |
偶数行 | 偶数行 |
此外,还可以使用:
来设置表格的对齐方式。
例如,如下的代码:
1 | | 左对齐 | 右对齐 | 居中对齐 | |
渲染的效果:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
引用
引用使用>
来进行标识,只要在文本前增加一个>
符号,该段文字就会自动变为引用文字。
例如,如下的代码:
1 | > 引用的文字 |
展示的效果如下所示:
引用的文字
Warn
使用引用的时候,请注意在引用符号这一段结束之后,务必增加一个空行,否则接下来的正文可能会被识别为引用的文字。
例如
1 | <!--错误示范--> |
渲染的效果如下:
引用文字
紧跟着引用的正文
正确的做法应当是:
1 | <!--正确示范--> |
渲染的效果如下:
引用文字
紧跟着引用的正文
代码
代码分为行内代码和行间代码。
行内代码
使用行内代码,需要使用 ` 号将代码包围。
如下列代码:
1 | `code` |
显示的效果为
code
行间代码
行间代码有两种方式分别是使用三个 ` 或者~来进行包围。
例如下列代码:
```
code
```
显示的效果为
1 | code |
~~~
code
~~~
显示的效果为:
1 | code |
Note
这里的源码暂时没有找到合适的方式,暂时先保持这个样子,以后找到解决方式再回来修改
链接
链接的使用方式为:[显示文字](链接地址)
或者为<链接地址>
如以下的源代码:
1 | [我的博客](https://blog.cflmy.cn/) |
显示的效果如下所示:
进阶配置
使用链接还有一种方式,非常类似于脚注。
例如下列代码:
1 | [我的博客][链接1] |
显示的效果为:
我的博客
此外,插入图片和插入链接十分类似,使用方式为
例如下列代码:
1 |  |
显示效果为:
分割线
使用三个-
可以制造一条分割线。
例如下列代码:
1 | --- |
显示的效果为:
后记
以上就是Markdown的基本语法,后续发现有遗漏的或许会再行补充。
同系列:
- Title: Markdown基础语法
- Author: 呆呆的猪胖胖
- Created at : 2025-03-19 10:30:00
- Updated at : 2025-05-13 15:34:47
- Link: https://blog.cflmy.cn/2025/03/19/Technology/Markdown/Markdown/
- License: This work is licensed under CC BY-NC-SA 4.0.