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

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

Markdown 是一种轻量级标记语言，以其简洁易读的语法成为开发者写作的首选。GitHub、飞书文档、Notion、Obsidian 等平台都支持 Markdown。本文带你系统掌握 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，可用于更复杂的排版需求：

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

Markdown 编辑器推荐

• Typora： 所见即所得，最优雅的 Markdown 编辑器
• VS Code： 配合 Markdown Preview Enhanced 插件
• Obsidian： 知识管理 + Markdown，支持双向链接
• 在线预览： 使用我们的 在线 Markdown 预览工具，实时渲染和编辑

各平台 Markdown 差异

不同平台对 Markdown 的支持有细微差异，了解这些可以帮助你避免格式问题：

• GitHub Flavored Markdown (GFM)： 支持表格、任务列表、Emoji 简码
• 飞书文档： 支持 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）、交叉引用等高级功能。