一、什么是 Markdown

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

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

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

二、标题

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

写法

1
2
3
4
# 一级标题
## 二级标题
### 三级标题
#### 四级标题

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

这是三级标题的效果

这是四级标题的效果

三、文本样式

加粗、斜体、删除线

写法

1
2
3
4
**加粗文字**
*斜体文字*
***加粗斜体***
~~删除线~~

效果

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

高亮与上下标

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

写法

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

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

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

四、列表

无序列表

写法

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

效果

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

有序列表

写法

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

效果

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

任务列表

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

写法

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

效果（原样）

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

五、链接与图片

链接

写法

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

效果

显示文字

图片

写法

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

效果

示例图片

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

六、代码

行内代码

写法

1
使用 `npm install` 安装依赖

效果

使用 npm install 安装依赖

代码块与语法高亮

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

1
2
3
4
```python
def hello():
    print("Hello, Markdown!")
```

效果

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

七、引用

写法

1
2
3
> 引用内容
>
> > 嵌套的二级引用

效果

引用内容

嵌套的二级引用

八、表格

写法

1
2
3
4
5
| 语法    | 含义   | 示例    |
| ------- | ------ | ------- |
| `**x**` | 加粗   | **x**   |
| `*x*`   | 斜体   | *x*     |
| `` `x` `` | 行内代码 | `x`  |

效果

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

九、分隔线

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

写法

1
---

效果

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

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

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

总结

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