一、什么是 Markdown？

Markdown 是一种轻量级的标记语言，设计用于让普通文本具有丰富的格式表现，同时保留文本内容的易读性和易写性。它通过简单直观的标记符号来实现文档的格式化，广泛应用于技术文档、博客文章、电子邮件、笔记和协作文档的编写。
AI输出内容的格式就是Markdown，学会Markdown，就可以高效的和ai协同合作，让AI能融入我们的工作流

二、为什么选择 Markdown？

1. 简单直观：语法⾮常容易掌握，只需熟悉常⻅标记符号即可快速上⼿。
2. 跨平台⽀持：⽀持多种平台和⼯具，如 GitHub、Notion、VS Code、Jupyter Notebook 等。
3. 多格式输出：⽂档可以转换为 HTML、PDF、Word 等多种格式，适应不同需求。
4. 专注创作：⽆需复杂的排版⼯具，专注内容本⾝，提⾼写作效率。

三、Markdown 语法详解

以下是 Markdown 的常用语法及其详细示例，点击标签可切换查看源码与效果：

1. 标题

Markdown 使用 # 符号来表示标题，支持六级标题， # 的数量代表标题的级别。

1
2
3
4
5
6

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 段落与换行

普通的文本直接书写即可。若需要换行，在行尾添加两个空格。

1
2

这是一段文字，行尾加两个空格后换行。  
这是下一行。

3. 强调

Markdown 支持斜体和加粗，以及两者的组合。

1
2
3

*斜体* 或 _斜体_
**加粗** 或 __加粗__
***斜体加加粗*** 或 ___斜体加加粗___

4. 列表

Markdown 支持无序列表和有序列表。

1
2
3
4
5

- 项目一
- 项目二
  - 子项目一
  - 子项目二
* 项目三

1
2
3
4

1. 项目一
2. 项目二
1. 子项目一
2. 子项目二

5. 链接与图片

添加超链接和图片的方式非常相似，图片只需在前面多加一个感叹号 !。

1
2
3
4
5

[链接文本](链接地址)
[Google](https://www.google.com)

带标题提示：
[Google](https://www.google.com "谷歌搜索")

1
2

![图片描述](图片地址)
![鹿乃.jpg](https://s2.loli.net/2024/10/27/1IiqvzVtnxEYuaT.jpg)

6. 引⽤

引用使用 > 进行标记，支持嵌套引用。

1
2

> 这是一个引用。
>> 这是嵌套引用。

7. 代码块

支持行内代码和多行代码块。

1

这是 `行内代码` 示例。

1
2

def hello():
    print("Hello, Markdown!")

8. 表格

使用 | 和 - 创建表格。

1
2
3
4

| 表头1 | 表头2 | 表头3 |
| ----- | ----- | ----- |
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

9. 分隔线与任务列表

1
2
3

- [ ] 任务一
- [x] 任务二
- [ ] 任务三

1
2
3

---
***
___

10. 公式与绘图

Markdown 支持 LaTeX 公式和 Mermaid 绘图（需编辑器支持）。

1

$\frac{a}{b}$

1
2
3
4

<pre class="mermaid">graph TD
    A[串口中断触发] --> B{串口号判断}
    B -->|USART1 或 USART3| C[检查字符是否为\n]
    C --> B</pre>

graph TD
    A[串口中断触发] --> B{串口号判断}
    B -->|USART1 或 USART3| C[检查字符是否为\n]
    C --> B