---
title: Markdown 使用指南
date: 2026-07-08 22:00:00
tags: [Markdown, 写作, 教程]
categories: 教程
cover: /images/Markdown使用指南/markdown.webp
description: 从零掌握 Markdown 常用语法。每条语法都先给「写法」再给「效果」，照抄即可。
---

## 一、什么是 Markdown

Markdown 是一种**轻量级标记语言**，用纯文本编写，通过简单符号控制排版。优点：

- 语法简单，几分钟上手；
- 专注内容，不被格式打扰；
- 通用性强，几乎所有博客、笔记、代码托管平台都支持。

下面每一条都先给**写法**（源码），紧接着给出**效果**（实际渲染结果），方便对照学习。

## 二、标题

用 `#` 的数量表示标题层级，`#` 越多级别越低（建议全文只有一个 `#` 一级标题）。

**写法**

```markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
```

**效果**（演示三级与四级，一、二级即本文各章节样式）

### 这是三级标题的效果

#### 这是四级标题的效果

## 三、文本样式

### 加粗、斜体、删除线

**写法**

```markdown
**加粗文字**
*斜体文字*
***加粗斜体***
~~删除线~~
```

**效果**

**加粗文字**
*斜体文字*
***加粗斜体***
~~删除线~~

### 高亮与上下标

> 以下为扩展语法，**标准 Markdown 不渲染**，仅在 Typora、部分平台支持，本站点同样不会渲染，这里如实展示原样。

**写法**

```markdown
==高亮文字==
上标：x^2^
下标：H~2~O
```

**效果（原样，因本站点不支持）**

==高亮文字==
上标：x^2^
下标：H~2~O

## 四、列表

### 无序列表

**写法**

```markdown
- 项目一
- 项目二
  - 子项目（前面加两个空格缩进）
```

**效果**

- 项目一
- 项目二
  - 子项目（前面加两个空格缩进）

### 有序列表

**写法**

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

**效果**

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

### 任务列表

> 任务列表为 GitHub 扩展语法，本站点不渲染复选框，这里展示原样写法。

**写法**

```markdown
- [x] 已完成的任务
- [ ] 待完成的任务
```

**效果（原样）**

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

## 五、链接与图片

### 链接

**写法**

```markdown
[显示文字](https://example.com "可选标题")
```

**效果**

[显示文字](https://example.com "可选标题")

### 图片

**写法**

```markdown
![图片描述](图片地址)
```

**效果**

![示例图片](/img/butterfly-icon.png)

> 提示：图片语法与链接几乎一样，区别仅在于最前面多一个 `!`。本地图片可写成 `/images/文章名/图片.webp`。

## 六、代码

### 行内代码

**写法**

```markdown
使用 `npm install` 安装依赖
```

**效果**

使用 `npm install` 安装依赖

### 代码块与语法高亮

**写法**（用四个反引号包裹，内部的三反引号才能原样显示）

````markdown
```python
def hello():
    print("Hello, Markdown!")
```
````

**效果**

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

## 七、引用

**写法**

```markdown
> 引用内容
>
> > 嵌套的二级引用
```

**效果**

> 引用内容
>
> > 嵌套的二级引用

## 八、表格

**写法**

```markdown
| 语法    | 含义   | 示例    |
| ------- | ------ | ------- |
| `**x**` | 加粗   | **x**   |
| `*x*`   | 斜体   | *x*     |
| `` `x` `` | 行内代码 | `x`  |
```

**效果**

| 语法    | 含义   | 示例    |
| ------- | ------ | ------- |
| `**x**` | 加粗   | **x**   |
| `*x*`   | 斜体   | *x*     |
| `` `x` `` | 行内代码 | `x`  |

## 九、分隔线

连续三个以上的 `-`、`*` 或 `_`（独占一行）即为分隔线。

**写法**

```markdown
---
```

**效果**

---

## 十、实用扩展（平台相关）

以下语法并非所有平台都支持，按平台能力选用：

- **脚注**：`正文[^1]` 配合文末 `[^1]: 注释内容`；
- **自动目录**：部分编辑器支持 `[TOC]`；
- **emoji**：`:smile:` 显示 😄（依赖平台）；
- **数学公式**：`$E=mc^2$` 行内，`$$...$$` 独立公式块；
- **流程图**：GitHub 等支持 Mermaid 语法。

## 总结

掌握标题、文本样式、列表、链接图片、代码、引用、表格、分隔线，已能应付 90% 写作场景。核心心法：**先写内容，再管格式**，其余交给 Markdown。把本文收藏，写文章时对照查阅即可。
