Markdown语法

什么是Markdown?

Markdown 是一种轻量级标记语言，它允许你使用纯文本格式编写文档，然后可以轻松地转换为结构化的 HTML（或其他格式）。它的核心理念是易读易写。

1. 标题

使用 # 符号来表示标题，# 的数量对应标题的级别（1-6级），注意**#**与文本之间有空格。

#  这是一级标题（H1）
## 这是二级标题（H2）
###  这是三级标题（H3）
#### 这是四级标题（H4）
##### 这是五级标题（H5）
###### 这是六级标题（H6）

效果：

这是一级标题（H1）

这是二级标题（H2）

这是三级标题 （H3）

---

2. 段落与换行

• 段落：用一个空行来分隔两个段落。

• 换行：在行尾添加两个空格再回车，或者直接回车（在某些解析器中，如 Typora，普通回车即可换行）。

这是第一个段落。  
这一行和上一行在同一段落，但被换行符分开。

这是第二个段落，由一个空行分隔。

---

3. 强调

*这是斜体文本*  或  _这也是斜体文本_
**这是粗体文本**  或  __这也是粗体文本__
***这是粗斜体文本***  或  ___这也是粗斜体___
~~这是删除线文本~~

效果：

这是斜体文本 或 这也是斜体文本
这是粗体文本 或 这也是粗体文本
这是粗斜体文本 或 这也是粗斜体 这是删除线文本

---

4. 列表

无序列表

使用 *、- 或 + 后跟一个空格。

- 项目一
- 项目二
  - 子项目二点一
  - 子项目二点二
- 项目三

效果：

• 项目一
• 项目二
  • 子项目二点一
  • 子项目二点二
• 项目三

有序列表

使用数字后跟一个点和一个空格。

1. 第一项
2. 第二项
   1. 子项一
   2. 子项二
3. 第三项

效果：

1. 第一项
2. 第二项
   1. 子项一
   2. 子项二
3. 第三项

---

5. 链接

[链接文本](URL "可选的标题")

示例：
访问 [Google](https://www.google.com) 进行搜索。
或者去 [OpenAI](https://www.openai.com "AI 研究实验室") 看看。

效果：
访问 Google 进行搜索。
或者去OpenAI 看看。

---

6. 图片

语法与链接类似，但在前面加一个 !。

![图片替代文本](图片URL "可选的标题")

示例：
![Markdown Logo](https://markdown-here.com/img/icon256.png "Markdown 图标")

---

7. 代码

行内代码

使用反引号 ` 包裹。

使用 `console.log()` 函数来打印信息。

效果：

使用 console.log() 函数来打印信息。

代码块

使用三个反引号 ```包裹代码，并可以指定语言以实现语法高亮。

	```javascript
	function greet(name) {
	  console.log(`Hello, ${name}!`);
	}
	
	```
	
	```python
	def greet(name):
	    print(f"Hello, {name}!")
	```

效果：

function greet(name) {
  console.log(`Hello, ${name}!`);
}

def greet(name):
    print(f"Hello, {name}!")

---

8. 表格

使用竖线 | 和连字符 - 来创建表格。

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 单元格内容 | 单元格内容 | 单元格内容 |
| 另一行 | 数据 | 数据 |

效果：

左对齐	居中对齐	右对齐
单元格内容	单元格内容	单元格内容
另一行	数据	数据

提示：:— 表示左对齐，:—: 表示居中对齐，—: 表示右对齐。

---

9. 水平线

使用多个的连字符 —、星号 *** 或下划线 ___ 来创建一条水平线。

---
***
___

效果：

---

---

———————————————————————————————————————————————————————————

10. 引用

使用 > 符号来表示引用块。

> 这是一个引用块。
> 它可以**跨越多行**。
>
> > 甚至还可以嵌套。

效果：

这是一个引用块。
它可以跨越多行。

甚至还可以嵌套。

---

11. 转义字符

如果你想要显示 Markdown 语法中的特殊字符（如 *、_、# 等），需要在它们前面加上反斜杠 \。

\*这不是斜体\*
\# 这不是标题

效果：
*这不是斜体*
# 这不是标题

---

12. 任务列表

使用连字符、空格和方括号 [ ] 或 [x]。

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个待办项

效果：

• 已完成的任务
• 未完成的任务
• 另一个待办项

---

13. 脚注

这是一个带有脚注的句子。[^1]

另一个脚注引用。[^2]

[^1]: 这是第一个脚注的详细内容。
[^2]: 这是第二个脚注的详细内容，可以很长。

效果：
这是一个带有脚注的句子。¹

另一个脚注引用。²

---

14. 拓展

许多平台（如 GitHub, GitLab）和编辑器（如 Typora, Obsidian）对标准 Markdown 进行了扩展。

• 数学公式：使用 $$ 包裹 LaTeX 公式。

行内公式： $E = mc^2$
块级公式：
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

效果：
行内公式： $E=m{c}^2$
块级公式：
$$\sum _{i=1}^{n}i=\frac{n(n+1)}{2}$$

---

• 高亮：使用** == **包裹文本

==这是高亮文本==

效果：
这是高亮文本

---

1. 这是第一个脚注的详细内容。 ↩︎

2. 这是第二个脚注的详细内容，可以很长。 ↩︎