Skip to main content

Markdown 指南

本文为 Markdown 使用指南，仅说明语法规则，不包含格式与排版建议。

参考资料​

简介​

2004 年，John Gruber 创造了 Markdown，一种专门针对网络写作的文本标记语言。使用 Markdown，你只需在写作过程中插入少量的标记符号，就能很轻松地进行排版（例如设置标题、加粗、列表、引用等）。

Markdown 文档以纯文本格式存储，这意味着，它们可以用几乎任一文本编辑器打开。同时，又能通过 Markdown 编辑器导出为带排版的富文本文档、HTML 网页等等。纯粹、简洁、易用、灵活，都是人们喜欢 Markdown 的原因。

推荐一个我常用的 Markdown 排版软件 Typora。

段落​

一个 段落 是由一个或多个连续的 文本行 组成，前后要有至少 11 个的 空行。

第一段
第一句
第二句

第二段
第三句
第四句
http://localhost:3000

第一段 第一句 第二句

第二段 第三句 第四句

标题​

使用 井号（#）表示 标题，1∼61\sim 6 个井号（#）分别对应 1∼61\sim 6 级标题。

# 一级标题示例

## 二级标题示例

### 三级标题示例

#### 四级标题示例

##### 五级标题示例

###### 六级标题示例

普通文本示例
http://localhost:3000

一级标题示例

二级标题示例

三级标题示例

四级标题示例

五级标题示例
六级标题示例

普通文本示例

强调​

加粗​

使用 双星号（**）或 双下划线（__）包围文字表示 加粗。

这是一个 **加粗** 示例。
http://localhost:3000

这是一个 加粗 示例。

斜体​

使用 单星号（*）或 单下划线（_）包围文字表示 斜体。

这是一个 _斜体_ 示例。
http://localhost:3000

这是一个 斜体 示例。

删除线​

使用 双波浪线（~~）包围文字表示 删除线。

这是一个 ~~删除线~~ 示例。
http://localhost:3000

这是一个 删除线 示例。

列表​

无序列表​

使用 连字符（-）、星号（*）或 加号（+）表示 无序列表。

- 无序列表 1
- 无序列表 2
- 无序列表 3
http://localhost:3000
  • 无序列表 1
  • 无序列表 2
  • 无序列表 3

有序列表​

使用 数字 + 句点 表示 有序列表。

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3
http://localhost:3000
  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3

任务列表​

使用 [ ] 或 [x] 表示 任务列表。

- [x] 任务列表 1
- [ ] 任务列表 2
- [x] 任务列表 3
http://localhost:3000
  • 任务列表 1
  • 任务列表 2
  • 任务列表 3

代码块​

行内代码​

使用 单反引号（`）表示 行内代码。

`Lorem ipsum`
http://localhost:3000

Lorem ipsum

行间代码​

使用 三反引号（```）表示 行间代码。

```cpp
#include <bits/stdc++.h>
using namespace std;

int main()
{
	cout<<"Hello, world!"<<'\n';
	return 0;
}
```
http://localhost:3000
#include <bits/stdc++.h>
using namespace std;

int main()
{
	cout<<"Hello, world!"<<'\n';
	return 0;
}

链接​

使用 [链接文本](链接地址) 插入 链接。

[Apple](https://www.apple.com)
http://localhost:3000

Apple

图片​

使用 ![替代文本](图片链接) 插入 图片。

![The Apple Store Shopping Event](https://store.storeimages.cdn-apple.com/1/as-images.apple.com/is/ase-header-hero-202511?wid=1392&hei=640&fmt=png-alpha&.v=YnRtS1pvZW0xTkRGTDArTFMxM1dkK2Y5c091MFJuNmVhOUl2Q2RwT0ZMOXZtdlBGOXJXZFNaUWV3K0pQbC96YXV3M2NIN0pZV0NOZE9oVm8rOFczOVM3MzU2aDRJWlJuTHd3RzJsT3JDc0k)
http://localhost:3000

The Apple Store Shopping Event

引用​

使用 大于号（>）表示 引用。

> 这是一个引用示例。
http://localhost:3000

这是一个引用示例。

表格​

使用 管道符（|）划分单元格，第二行使用 冒号（:）和 连字符（-）设置对齐方式。

| 此行左对齐 | 此行居中对齐 | 此行右对齐 |
| :--------- | :----------: | ---------: |
| 内容 1     |    内容 2    |     内容 3 |
http://localhost:3000
此行左对齐此行居中对齐此行右对齐
内容 1内容 2内容 3

分隔线​

使用至少 33 个 连字符（-）或 星号（*）表示 分隔线。该行不能包含其他内容，但可以插入空格。

---
http://localhost:3000