Markdown 语法简介

前言

Markdown 是一种轻量级标记语言，它用简单的纯文本符号来表达格式，写起来像普通文字，读起来也不费劲，却能轻松转换成 HTML、PDF 等格式。如今它已是写博客、记笔记、写文档的通用语言——GitHub、简书、Notion、Typora 里都少不了它。

AI时代必须学会Markdown！

一、标题

用 # 表示标题，几个 # 就是几级标题，最多六级。

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

小提示：# 和标题文字之间要留一个空格。

二、段落与换行

• 段落：连续的文字就是一段，段落之间空一行即可。
• 换行：行尾加两个空格再回车，或者直接空一行另起一段。

这是第一段。

这是第二段。

三、强调

*斜体* 或 _斜体_
**加粗** 或 __加粗__
***加粗斜体***
~~删除线~~

效果：斜体、加粗、加粗斜体、删除线

四、列表

无序列表

用 -、* 或 + 开头：

- 苹果
- 香蕉
- 橙子

有序列表

用数字加英文句点：

1. 第一步
2. 第二步
3. 第三步

嵌套列表

子项缩进两个或四个空格：

- 前端
  - HTML
  - CSS
- 后端
  - Java
  - Python

五、链接与图片

链接

/[链接文字/]/(链接地址/)
/[带标题的链接/]/(链接地址 "鼠标悬停显示"/)

图片

/!/[图片描述/]/(图片链接地址/)
/!/[图片描述/]/(图片路径 "可选标题"/)

图片语法就是链接前面加一个 !。方括号里是图片的替代文字，图片加载失败时会显示。
(华为的markdown编辑器有bug，注意去掉反编译符号)

六、引用

用 > 开头，可以嵌套：

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

效果：

这是一段引用。

这是嵌套引用。

七、代码

行内代码

用反引号包裹：

使用 `console.log()` 输出日志。

代码块

用三个反引号包裹，并可在开头注明语言以启用语法高亮：

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

八、分隔线

单独一行写三个或以上的 -、*、_：

---

九、表格

用 | 分隔单元格，第二行用 - 定义表头分隔，冒号控制对齐：

| 姓名 | 年龄 | 城市 |
| :--- | :---: | ---: |
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |

其中 :--- 左对齐，:---: 居中，---: 右对齐。

十、任务列表

- [x] 已完成的任务
- [ ] 未完成的任务

效果：

• [x] 已完成的任务
• [ ] 未完成的任务

十一、转义字符

想显示 Markdown 的特殊符号本身，在符号前加反斜杠 \：

\*这不是斜体\*

支持转义的符号包括 \ ` * _ {} [] () # + - . ! 等。

十二、HTML 支持

大多数 Markdown 解析器允许直接嵌入 HTML：

这是<strong>加粗</strong>文字，<br>这里换行。

常用语法速查表