Markdown 语法完全指南

今天这一篇详细介绍一下Markdown的语法。

一、工作中最常见的语法（10分钟上手）

1. 标题

用 # 表示标题，1-6 个 # 对应 1-6 级标题。

# 一级标题（文章标题）
## 二级标题（章节标题）
### 三级标题（小节标题）
#### 四级标题

2. 段落与换行

直接输入文字就是段落，段落之间空一行。

如果只是换行，在行末加两个空格 或按 Shift+Enter。

这是第一段。

这是第二段。

3. 文字强调

**这是加粗**（Ctrl+B）
*这是斜体*（Ctrl+I）
***这是粗斜体***
`这是行内代码`（反引号包裹）

效果：这是加粗、这是斜体、粗斜体、行内代码

4. 列表

无序列表：用 - 或 * 或 + 开头

- 需求评审
- 技术方案
- 开发联调

有序列表：用数字加 . 开头

1. 打开项目
2. 修改代码
3. 提交 PR

嵌套列表：子列表缩进 2 个空格

1. 前端开发
   - Vue 组件
   - React 组件
2. 后端开发
   - API 接口

5. 链接与图片

[链接文字](https://www.example.com)
![图片说明](https://www.example.com/image.png)

💡 小技巧：图片链接前加 !，链接不加。

6. 引用

> 这是引用内容，适合放名人名言或重点提示。
> 
> 多行引用需要空行。

效果：

这是引用内容，适合放名人名言或重点提示。

7. 代码块

用三个反引号 ``` 包裹，并指定语言：

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

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

8. 分隔线

三个及以上的 - 或 *：

---
***

9. 表格

用 | 分隔列，用 --- 分隔表头：

| 姓名 | 职位 | 状态 |
|------|------|------|
| 张三 | 前端 | 在职 |
| 李四 | 后端 | 在职 |

姓名	职位	状态
张三	前端	在职
李四	后端	在职

💡 对齐方式：:--- 左对齐，---: 右对齐，:---: 居中。

---

二、拓展语法（进阶玩法）

1. 任务列表（To-do）

- [x] 已完成：需求文档
- [ ] 待完成：技术评审
- [ ] 待完成：代码开发

• • 已完成：需求文档
• • 待完成：技术评审
• • 待完成：代码开发

2. 删除线

~~这段文字已废弃~~

这段文字已废弃

3. 脚注

Markdown 是一个轻量级标记语言[^1]。

[^1]: 由 John Gruber 和 Aaron Swartz 创建。

4. 目录自动生成

[TOC]  <!-- 部分编辑器支持，如 Typora -->

或在 VS Code 中使用插件自动生成。

5. Mermaid 图表（流程图/时序图）

```mermaid
graph LR
    A[开始] --> B{判断}
    B -->|条件1| C[处理1]
    B -->|条件2| D[处理2]
    C --> E[结束]
    D --> E
```

 

条件1

 

 

条件2

 

开始判断处理1处理2结束

6. 数学公式（LaTeX）

行内公式：$E = mc^2$

块级公式：
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

7. HTML 嵌入

Markdown 支持直接写 HTML，实现更复杂的排版：

<<center>居中文字</center>
<span style="color:red">红色文字</span>
<details>
<summary>点击展开</summary>
折叠内容
</details>

---

三、在哪里写 Markdown？

1. VS Code

如果你已经有 VS Code，直接打开 .md 文件即可编辑。

• • 实时预览：按 Ctrl+Shift+V 打开预览窗口
• • 插件推荐：
• • Markdown All in One：快捷键、目录、数学公式支持
• • Markdown Preview Enhanced：增强预览，支持 Mermaid、LaTeX
• • Paste Image：直接粘贴截图自动转 Markdown 图片语法

2. 专门的 Markdown 编辑器

工具	特点	下载地址
Mark Text	开源实时预览，界面简洁，功能完整	https://github.com/marktext/marktext/
Zettlr	学术写作导向，支持引用管理和论文写作	https://github.com/Zettlr/Zettlr
Joplin	免费开源的笔记应用，支持 Markdown 全功能	https://joplinapp.org/

3. 在线编辑器（无需安装，即开即用）

工具	特点	地址
菜鸟工具	中文界面，实时预览	https://www.jyshare.com/front-end/712/
Dillinger	功能齐全，支持云同步和多种导出	https://dillinger.io/
StackEdit	与 Google Drive、Dropbox 集成	https://stackedit.io/
简书 / 语雀	国内平台，适合发布文章	直接搜索官网

---

🎯 快速上手指南

场景	推荐工具
写技术文档 / 代码 README	VS Code
记笔记 / 知识管理	Joplin、语雀
写论文 / 学术写作	Zettlr
临时编辑 / 快速预览	菜鸟在线编辑器
发布到公众号 / 知乎 / 简书	Mark Text 写好，再复制粘贴

---

一句话总结：Markdown 的核心就是「用简单的符号控制格式，让你专注写作」。掌握上面第一部分的 9 个语法，已经能覆盖 90% 的工作场景。赶紧打开编辑器试试吧！✍️