Markdown 基础语法

本章节主要面向新手编者用于快速上手编辑 Markdown 文本

基础语法

标题与段落

Markdown 支持 1-6 级标题，# 数量代表标题层级，# 越少字号越大。

Markdown 源码语法	常用方法与解释
# 一级标题	只存在于文章首且于文章名一致
## 二级标题	主段落
### 三级标题	次段落
#### 四级标题	小节（很少使用）
##### 五级标题	次小节（基本不用）
###### 六级标题	次次小节（基本不用）

渲染预览效果

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

一，二级标题自带分隔线，四，五，六级标题在“本节目录”中将不会显示

文本样式

样式	Markdown 源码语法	渲染预览效果
斜体	*斜体文本* 或 _斜体文本_	斜体文本
加粗	**加粗文本**	加粗文本
加粗斜体	***加粗斜体文本***	加粗斜体文本
删除线	~~删除线文本~~	删除线文本

段落、换行与分隔线

段落与换行规则

• 分段：段落之间空一行

• 换行：行末尾输入 两个空格 回车，或使用 <br/>

分隔线对照

三个减号-

---

三个新号*

---

减号-和星号*形成的分隔线是一样的，只是两种不同的写法

列表语法

无序列表

支持 -、+、* 三种符号，符号后必须加空格。

源码语法

- 列表项1
- 列表项2
- 列表项3

渲染预览效果

• 列表项1
• 列表项2
• 列表项3

有序列表

格式：数字 + .+ 空格 + 项目名，序号会自动排序。

源码语法

1. 列表项1
2. 列表项2
3. 列表项3

渲染预览效果

1. 列表项1
2. 列表项2
3. 列表项3

嵌套列表

源码语法

- 一级列表
  - 二级嵌套列表1
  - 二级嵌套列表2
    1. 三级有序列表
    2. 三级有序列表

渲染预览效果

• 一级列表
  • 二级嵌套列表1
  • 二级嵌套列表2
    1. 三级有序列表
    2. 三级有序列表

任务清单

源码语法

- [ ] 未完成任务
- [x] 已完成任务（x不分大小写）

渲染预览效果

• [ ] 未完成任务
• [x] 已完成任务（x不分大小写）

代码语法

行内代码

源码语法

这是 `一段文字` 或者 `变量` 等其他 `需要高亮的内容或代码` ，用两个 `反引号` 括起。

渲染预览效果

这是 一段文字 或者 变量 等其他 需要高亮的内容或代码 ，用两个 反引号 括起。

多行代码块

三个反引号+语言名称，结尾三个反引号闭合

源码语法及其预览效果

# python示例
def hello():
    print("Hello Markdown")

链接与图片语法

超链接

百科站内部链接

源码：[食物与腐败](/theory/food)

效果：食物与腐败

外部链接

源码：[百度](https://www.baidu.com)

效果：百度

裸链接

源码：<https://www.baidu.com>

效果：https://www.baidu.com

图片插入

编者注意

在本百科不使用!语法进行插入图片，后面会讲到

图片语法比链接多一个 !，支持本地图片、网络图片。

Markdown 源码语法	说明
	标准图片语法，描述可省略

表格语法

支持左对齐、居中对齐、右对齐，所有平台通用。

基础表格

源码语法

| 姓名 | 年龄 | 职业 |
| ---- | ---- | ---- |
| 张三 | 20 | 工程师 |
| 李四 | 22 | 设计师 |

渲染预览效果

姓名	年龄	职业
张三	20	工程师
李四	22	设计师

第二行是表头和内容的分界线，不可省略且与表格列数保证一致，但是里面的减号-数量无要求

表格对齐方式

• 左对齐（默认）：:---

• 居中对齐：:---:

• 右对齐：---:

引用语法

基础引用

源码语法：> 这是单行引用文本

渲染预览效果

这是单行引用文本

多行嵌套引用

源码语法

> 一级引用
> 多行引用内容
> - 还能嵌套其他语法
> - 喵喵喵
> > 二级嵌套引用

渲染预览效果

一级引用 多行引用内容

• 还能嵌套其他语法
• 喵喵喵

二级嵌套引用

高级拓展语法

转义字符

当需要显示 # * - ` 等特殊符号时，前方加 \ 转义，避免被解析为语法。

示例1

源码：\# 不生效的标题符号

效果：# 不生效的标题符号

示例2

源码：\*普通星号\*

效果：*普通星号*

示例3

源码：\<3 <3

效果：<3 ❤️

目录跳转

源码：[食物与腐败](/theory/food)

效果：食物与腐败

练习区

各位新手编者可以在这里练习语法并使用npm run docs:dev预览改动，练完记得清空喵
如果你是读者，这里什么都没有是正常的