Markdown 基本语法教程

概述

Markdown 是一种轻量级标记语言，由 John Gruber 创建。它的目标是实现「易读易写」。你可以使用简单的文本和一些特殊符号来格式化文档，然后这些文档可以轻松地转换为结构化的 HTML 、PDF 或其他格式。
它被广泛用于撰写博客、技术文档、README 文件、论坛帖子和即时消息。

核心语法

标题 (Headings)

使用井号 # 来创建标题，# 的数量对应标题的级别（<h1> 到 <h6>）。# 和标题文字之间建议保留一个空格。

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

段落和换行 (Paragraphs & Line Breaks)

段落是由一个或多个连续的文本行组成，段落之间用一个空行来分隔。
如果你想在段落内强制换行（创建一个 <br> 标签），可以在一行的末尾输入两个或更多的空格，然后按回车。

这是一个段落。我们在这里写一些文字。

这是另一个段落，通过一个空行与上一个段落分隔。

我想在这里强制换行。  <-- 这里结尾有两个空格
所以这一行会另起一行显示。

强调 (Emphasis)

粗体：使用两个星号 ** 或两个下划线 __ 包裹。
斜体：使用一个星号 * 或一个下划线 _ 包裹。
粗斜体：使用三个星号 *** 或三个下划线 ___ 包裹。
删除线：使用两个波浪号 ~~ 包裹。

**这是粗体**
__这也是粗体__

*这是斜体*
_这也是斜体_

***这是粗斜体***
___这也是粗斜体___

~~这段文字会被划掉~~

无序列表

使用星号 *、加号 + 或减号 - 来创建无序列表。符号和文字之间需要一个空格。

- 列表项一
- 列表项二
  - 嵌套列表项 A (通过缩进创建)
  - 嵌套列表项 B
* 列表项三
+ 列表项四

有序列表

使用数字加英文句点 . 来创建有序列表。数字的顺序不重要，Markdown 会自动为你排序。

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

1. 苹果
1. 橘子
8. 香蕉  <-- 即使这里是8，也会被渲染成3

链接 (Links)

链接的语法是 [链接显示的文字](链接地址 "可选的标题")。

[访问 Google](https://www.google.com "Google 官网")

图片 (Images)

图片的语法与链接非常相似，只是在前面多一个感叹号 !。语法是 ![图片的替代文字](图片地址 "可选的标题")。

![Markdown Logo](https://markdown.com.cn/assets/img/ico.png "Markdown 图标")

内联代码

使用反引号 ` 包裹一小段代码。

在 JavaScript 中，你可以使用 `console.log()` 来打印信息。

代码块

使用三个反引号 或三个波浪号 ~~~ 将多行代码包裹起来。你还可以在开头的 后面指定编程语言，以实现语法高亮。

引用 (Blockquotes)

在段落前使用大于号 > 来创建引用。可以嵌套使用。

> 这是第一层引用。
>
> > 这是嵌套的引用。
>
> 回到第一层。

分隔线 (Horizontal Rules)

在一行中使用三个或更多的星号 *、减号 --- 或下划线 _ 来创建一条水平分隔线。

---
***

扩展语法

表格 (Tables)

使用管道符 | 来分隔单元格，使用连字符 - 来分隔表头和表体。可以使用冒号 : 来定义对齐方式。

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :----: | ---: |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

任务列表 (Task Lists)

在列表项前使用 [ ] 或 [x] 来创建任务列表。

- [x] 完成报告
- [ ] 回复邮件
- [ ] 喝杯咖啡

概述