Markdown 语法参考
warning:
这篇文章距离上次修改已过1370天,其中的内容可能已经有所变动。
Typecho和hexo,都使用 Markdown 作为其内容书写语法。
这是因为相较于富文本语法来说, Markdown 更加简洁,原始文件即使没有引擎解析仍然有很好的易读性。
最重要的是 Markdown 通过简单语法,让人们专注于文字书写。
Markdown 编写的文档后缀为 .md
或.markdown
。
下面是一些 Markdown 常用语法。
Markdown 标题
Markdown 通过 # + 空格 + 标题内容
的方式,来定义一个标题。
其中#
的多少表示这是第几级标题,最多可以有6级。
# 第一级标题
## 第二级标题
### 第三级标题
#### 第四级标题
##### 第五级标题
###### 第六级标题
Markdown 字体
- 加粗:在需要 加粗 的内容左右添加
**
- 斜体:在需要 斜体 的内容左右添加
*
- 删除线:在需要 删除线 的内容左右添加
~~
- 斜体加粗:在需要 斜体加粗 的内容左右添加
***
**这是需要 加粗 的内容**
*这是需要 斜体 的内容*
~~这是需要 删除线 的内容~~
***这是需要 斜体+加粗 的内容***
Markdown 引用
Markdown 通过 > + 空格 + 引用内容
的方式,来定义一个引用。
引用可以嵌套,只需要使用多个>
即可
> 这是一个引用
>>这是一个嵌套引用
>>>>>>>>>>当然您可以多层嵌套
Markdown 列表
info:无序列表和有序列表可以混合使用
无序列表
Markdown 通过 - + 空格 + 无序列表内容
的方式,来定义一个无序列表。
通过缩进的方式来确定无序类表等级。
- 无序列表内容
- 无序列表内容
- 无序列表内容
- 第一级无序列表内容
- 第二级无序列表内容
- 第三级无序列表内容
- 第四级无序列表内容
有序列表
Markdown 通过 数字 + . + 空格 + 有序列表内容
的方式,来定义一个有序列表。
通过缩进的方式来确定有序类表等级。
1. 有序列表内容
2. 有序列表内容
3. 有序列表内容
1. 第一级有序列表内容
1. 第二级有序列表内容
2. 第二级有序列表内容
3. 第二级有序列表内容
2. 第一级有序列表内容
1. 第二级有序列表内容
2. 第二级有序列表内容
3. 第二级有序列表内容
3. 第一级有序列表内容
1. 第二级有序列表内容
2. 第二级有序列表内容
3. 第二级有序列表内容
Markdown 分割线
Markdown 通过 3个及以上数量连续的*
或-
,来定义一个分割线。
---
----
***
*****
Markdown 超链接
Markdown 通过 [超链接名](超链接地址 "超链接title")
,来插入一个超链接。其中 title 可以省略。
[百度](https://www.baidu.com)
[idzd](https://www.idzd.top/ "我的个人博客")
Markdown 图片
Markdown 通过 ![图片说明](图片地址 ''图片title'')
,来插入一个图片。其中 title 可以省略。
当然,也可以和 超链接 语法混合使用。达到点击图片跳转指定地址效果。
![网站logo](https://www.idzd.top/logo.png "网站logo")
[![点击前往博客首页](https://www.idzd.top/logo.png "点击前往博客首页")](https://www.idzd.top/ "点击前往博客首页")
Markdown 代码块
Markdown 代码块主要有3种风格
- 行内代码块,用一个反单引号包裹
- 多行代码块(缩进风格),用多个空格缩进来表示
- 多行代码块(多语言风格),用3个反单引号包裹,并设置代码语言。
`这是行内代码块`
这是多行代码块(缩进风格)
这是多行代码块(缩进风格)
这是多行代码块(缩进风格)
(```markdown)
这是多行代码块(多语言风格)
这是多行代码块(多语言风格)
这是多行代码块(多语言风格)
(```)
Markdown 表格
Markdown 表格绘制语法如下:
第二行分割表头与内容
- 默认内容左对齐,当然左侧加
:
也表示左对齐 - 两边加
:
内容居中 - 右侧加
:
内容右对齐
- 默认内容左对齐,当然左侧加
- 原生语法要求用
|
包围整个表格。部分解析引擎可以省略。
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
Markdown 流程图
部分Markdown解析引擎或客户端支持此功能。
Markdown 脚注
Markdown 通过 需要脚注的部分 + [^ 脚注内容]
,来插入一个脚注。
这是脚注[^这里是 **脚注** 的 *内容*.].
这是脚注1.
- 这里是 脚注 的 内容. ↩