跳转至

📝 Markdown 语法完全指南

轻量级标记语言，让写作更简单高效

📚 覆盖全部语法 🚀 实例演示 💡 实用技巧

快速导航 | 基础语法 | 高级语法 | 实用技巧 | 在线工具

📖 什么是 Markdown？

Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。

为什么选择 Markdown？

  • ✅ 简单易学 - 语法简洁明了
  • ✅ 跨平台 - 纯文本格式，任何编辑器都能打开
  • ✅ 格式丰富 - 支持导出 HTML、PDF、Word 等格式
  • ✅ 版本控制友好 - Git 等工具完美支持
  • ✅ 广泛支持 - GitHub、博客平台、文档工具都支持

🛠️ 推荐工具

平台 工具 特点
macOS MacDown 免费、实时预览
macOS Typora 所见即所得
Windows Typora 跨平台、优雅界面
Linux ReText 开源、轻量级

基础语法

🎯 标题

1
2
3
4
5
6
# 一级标题
## 二级标题  
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

标题技巧

  • # 后面需要加空格
  • 最多支持 6 级标题
  • 建议使用 ATX 风格（#）而非 Setext 风格

✨ 文本样式

样式 语法 效果
粗体 **文本** 或 __文本__ 粗体文本
斜体 *文本* 或 _文本_ 斜体文本
粗斜体 ***文本*** 粗斜体文本
删除线 ~~文本~~ 删除文本
高亮 ==文本== 高亮文本
下划线 <u>文本</u> 下划线文本

📋 列表

无序列表

1
2
3
4
5
6
- 项目 1
- 项目 2
  - 子项目 2.1
  - 子项目 2.2
    - 子子项目 2.2.1
- 项目 3

效果：

  • 项目 1
  • 项目 2
  • 子项目 2.1
  • 子项目 2.2
    • 子子项目 2.2.1
  • 项目 3

有序列表

1
2
3
4
5
1. 第一项
2. 第二项
   1. 子项目 2.1
   2. 子项目 2.2
3. 第三项

效果：
1. 第一项
2. 第二项
1. 子项目 2.1
2. 子项目 2.2
3. 第三项

任务列表

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [x] ~~已取消任务~~

效果：
- [x] 已完成任务
- [ ] 未完成任务
- [x] 已取消任务

🔗 链接和图片

链接语法

1
2
[链接文本](URL "可选标题")
[GitHub](https://github.com "全球最大代码托管平台")

效果： GitHub

图片语法

1
2
![图片描述](图片URL "可选标题")
![Markdown Logo](https://markdown-here.com/img/icon256.png "Markdown")

📊 表格

1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1  |   内容2   |  内容3 |
| 内容4  |   内容5   |  内容6 |

效果：

左对齐 居中对齐 右对齐
内容1 内容2 内容3
内容4 内容5 内容6

💻 代码

行内代码

1
使用 `printf()` 函数输出文本

效果： 使用 printf() 函数输出文本

代码块

1
2
3
4
5
6
7
8
```python
def hello_world():
    print("Hello, Markdown!")
    return "Success"

# 调用函数
hello_world()
```

效果： 

1
2
3
4
5
6
def hello_world():
    print("Hello, Markdown!")
    return "Success"

# 调用函数
hello_world()

📌 引用

1
2
3
4
5
> 这是一级引用
> 
> > 这是二级引用
> > 
> > > 这是三级引用

效果：

这是一级引用

这是二级引用

这是三级引用

📏 分割线

1
2
3
---
***
___

效果：

高级语法

🎨 HTML 标签

Markdown 支持内嵌 HTML 标签：

1
2
3
4
<div style="color: red; text-align: center;">
  <h3>红色居中标题</h3>
  <p>这是一段红色的文字</p>
</div>

效果：

红色居中标题

这是一段红色的文字

🔖 锚点链接

1
2
3
4
[跳转到顶部](#top)
[跳转到底部](#bottom)

<span id="bottom">这里是底部</span>

效果： 跳转到顶部 | 跳转到底部

📝 脚注

1
2
3
4
这里有一个脚注[^1]，还有另一个脚注[^note]。

[^1]: 这是第一个脚注
[^note]: 这是一个带名称的脚注

效果： 这里有一个脚注1，还有另一个脚注2。

🧮 数学公式

行内公式

1
爱因斯坦的质能方程：$E = mc^2$

效果： 爱因斯坦的质能方程：\(E = mc^2\)

块级公式

1
2
3
4
5
6
7
8
$$
\begin{align}
\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} &= \frac{4\pi}{c}\vec{\mathbf{j}} \\
\nabla \cdot \vec{\mathbf{E}} &= 4 \pi \rho \\
\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} &= \vec{\mathbf{0}} \\
\nabla \cdot \vec{\mathbf{B}} &= 0
\end{align}
$$

效果：

\[ \begin{align} \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} &= \frac{4\pi}{c}\vec{\mathbf{j}} \\ \nabla \cdot \vec{\mathbf{E}} &= 4 \pi \rho \\ \nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} &= \vec{\mathbf{0}} \\ \nabla \cdot \vec{\mathbf{B}} &= 0 \end{align} \]

实用技巧

🔤 特殊字符

字符 HTML 实体 显示
空格 &nbsp;  
小于号 &lt; <
大于号 &gt; >
与符号 &amp; &
引号 &quot; "

💬 注释

1
2
3
4
<!-- 这是注释，不会显示在页面上 -->

[//]: # (这也是注释)
[comment]: <> (另一种注释方式)

🎯 转义字符

使用反斜杠 \ 转义特殊字符：

1
2
\*这里不会变成斜体\*
\#这里不会变成标题

效果： *这里不会变成斜体* #这里不会变成标题

📱 响应式设计

1
2
3
4
5
<div style="display: flex; flex-wrap: wrap; gap: 10px;">
  <div style="flex: 1; min-width: 200px;">列1内容</div>
  <div style="flex: 1; min-width: 200px;">列2内容</div>
  <div style="flex: 1; min-width: 200px;">列3内容</div>
</div>

在线工具

📚 学习资源

🛠️ 实用工具

📖 扩展语法

GitHub Flavored Markdown

GitHub 支持的扩展语法包括： - [x] 任务列表 - :emoji: Emoji 支持 - 表格 - 删除线 - 语法高亮

🎉 总结

Markdown 是一个强大而简洁的文档格式化工具。掌握这些语法后，你可以：

  1. ✍️ 高效写作 - 专注内容而非格式
  2. 📝 文档管理 - 版本控制友好
  3. 🌐 多平台发布 - 一次编写，多处使用
  4. 🤝 团队协作 - 标准化的文档格式

最佳实践

  • 保持语法简洁，避免过度使用 HTML
  • 使用一致的格式风格
  • 适当使用空行增强可读性
  • 为图片添加描述性的 alt 文本
  • 使用有意义的链接文本

参考资源：

文章结尾 | 返回顶部 | 基础语法 | 高级语法

  1. Markdown是一种纯文本标记语言，由John Gruber创建 ↩

  2. HyperText Markup Language 超文本标记语言 ↩