blog/source/_posts/Markdown使用指南.md

title, date, tags, categories, cover, description

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

一、什么是 Markdown

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

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

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

二、标题

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

写法

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

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

这是三级标题的效果

这是四级标题的效果

三、文本样式

加粗、斜体、删除线

写法

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

效果

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

高亮与上下标

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

写法

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

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

==高亮文字== 上标：x^2^ 下标：H2O

四、列表

无序列表

写法

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

效果

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

有序列表

写法

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

效果

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

任务列表

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

写法

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

效果（原样）

• 已完成的任务
• 待完成的任务

五、链接与图片

链接

写法

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

效果

显示文字

图片

写法

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

效果

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

六、代码

行内代码

写法

使用 `npm install` 安装依赖

效果

使用 npm install 安装依赖

代码块与语法高亮

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

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

效果

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

七、引用

写法

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

效果

引用内容

嵌套的二级引用

八、表格

写法

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

效果

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

九、分隔线

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

写法

---

效果

---

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

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

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

总结

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