📝 Markdown 语法完全教程：从入门到精通

2026年5月9日 · 阅读约 12 分钟

这份 README 就是用 Markdown 写的。你正在读的这篇博客也是。GitHub、飞书文档、Notion、Obsidian——几乎所有你听说过的写作平台都支持它。Markdown 到底好在哪？一句话：让你只关心写什么，不关心怎么排版。

为什么选择 Markdown？

• 极简语法： 几分钟就能上手，真的
• 纯文本： 记事本都能打开编辑
• 版本控制友好： Git diff 出来清清楚楚
• 跨平台： 同一个文件，换个工具照样渲染
• 专注内容： 不用操心字号、颜色、对齐那些事

基础语法

标题

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

文本样式

*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体***
~~删除线~~
`行内代码`
上标^2^（部分平台支持）

列表

无序列表：
- 项目一
- 项目二
  - 子项目
  - 子项目

有序列表：
1. 第一步
2. 第二步
3. 第三步

链接与图片

[链接文字](https://example.com)
![图片描述](https://example.com/image.png)

代码块

```javascript
function hello() {
  console.log("Hello, World!");
}
```

引用

> 这是引用文本
> 多行引用
>> 嵌套引用

分隔线

---

进阶语法

表格

| 姓名 | 年龄 | 城市 |
|------|------|------|
| 张三 | 28   | 北京 |
| 李四 | 32   | 上海 |

任务列表（GitHub 支持）

- [x] 已完成任务
- [ ] 待办任务
- [ ] 另一个待办

脚注

这是一个带脚注的句子[^1]。
[^1]: 这是脚注内容。

HTML 嵌入

Markdown 的隐藏能力：直接写 HTML 标签。遇到 Markdown 搞不定的排版，直接上 HTML：

<details>
  <summary>点击展开</summary>
  这里是隐藏内容
</details>

Markdown 编辑器推荐

• Typora： 所见即所得，最优雅的 Markdown 编辑器，没有之一
• VS Code： 安装 Markdown Preview Enhanced 插件，边写边预览
• Obsidian： 知识管理神器，Markdown 原生支持，双向链接无敌
• 在线预览： 用我们的 在线 Markdown 预览工具，实时渲染，不用装任何软件

各平台 Markdown 差异

不同平台的 Markdown 实现有细微差别，知道这些能避免格式翻车：

• GitHub Flavored Markdown (GFM)： 支持表格、任务列表、Emoji 简码（比如 :smile:）
• 飞书文档： 支持 Markdown 快捷语法一键转富文本
• Notion： 斜杠命令 + Markdown 混合使用
• Jekyll/Hexo： 用 YAML Front Matter 写博客头信息

Markdown 最佳实践

• 标题之间保留空行——不然有些渲染器会搞混
• 统一用 - 做无序列表标记
• 代码块指定语言，才能高亮
• 链接文字要有描述性，别写"点击这里"
• 长文档加个目录（Table of Contents）

常见问题

Q: Markdown 和富文本编辑器哪个更好？

Markdown 适合需要版本控制和跨平台协作的场景；富文本适合不需要技术背景的普通用户。两者可以互补。

Q: Markdown 能转成其他格式吗？

Pandoc 是文档转换的神器，Markdown ↔ HTML/PDF/DOCX/LaTeX 等 30+ 格式互转，一个命令搞定。

Q: 如何用 Markdown 写学术论文？

用 Pandoc + LaTeX 模板，支持引用管理（BibTeX）、公式渲染（MathJax）、交叉引用等高级功能。