Markdown 语法指南
为初学者打造的终极图文教程。轻量、高效、易读,让写作回归纯粹。
什么是 Markdown?
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后将其转换成有效的 XHTML(或者 HTML)。
优点: 专注写作、格式统一、跨平台兼容、Git 友好。
💡 快速了解
诞生时间:2004年由 John Gruber 创建
文件扩展名:.md 或 .markdown
应用场景:技术文档、博客写作、README 文件、笔记记录等
文件扩展名:.md 或 .markdown
应用场景:技术文档、博客写作、README 文件、笔记记录等
基础语法详解
标题 (Headers)
使用 # 号可表示 1-6 级标题,# 号数量对应标题级别。
Markdown 写法
# 一级标题
## 二级标题
### 三级标题
渲染效果预览
一级标题
二级标题
三级标题
段落与换行
段落之间使用空行隔开。如果需要在段落内强制换行,请在行尾加两个空格。
Markdown 写法
这是第一段。
这是第二段。
这是一行文字 (这里有两个空格)
这是换行后的文字。
渲染效果预览
这是第一段。
这是第二段。
这是一行文字
这是换行后的文字。
文本强调
Markdown 写法
**粗体文本**
*斜体文本*
~~删除线~~
渲染效果预览
粗体文本
斜体文本
删除线
斜体文本
列表
Markdown 写法
- 无序列表项 1
- 无序列表项 2
- 嵌套列表项 2.1
- 嵌套列表项 2.2
1. 有序列表项 1
2. 有序列表项 2
1. 嵌套有序列表 2.1
2. 嵌套有序列表 2.2
渲染效果预览
- 无序列表项 1
- 无序列表项 2
- 嵌套列表项 2.1
- 嵌套列表项 2.2
- 有序列表项 1
- 有序列表项 2
- 嵌套有序列表 2.1
- 嵌套有序列表 2.2
链接与图片
链接和图片的语法非常相似,图片仅多一个感叹号 !。
Markdown 写法
[点击访问 Google](https://google.com)

渲染效果预览
引用
Markdown 写法
> 这是一段引用文本。
> 知识就是力量。
渲染效果预览
这是一段引用文本。
知识就是力量。
代码
Markdown 写法
行内代码:`print()`
代码块:
```python
def hello():
print("Hi")
```
渲染效果预览
行内代码:
print()
def hello():
print("Hi")
水平分割线
使用三个或更多的短横线、星号或下划线。
Markdown 写法
---
***
___
渲染效果预览
转义字符
使用反斜杠 \ 转义 Markdown 特殊字符,使其显示为普通字符。
Markdown 写法
\* 不是列表
\# 不是标题
\[link\] 不是链接
渲染效果预览
* 不是列表
# 不是标题
[link] 不是链接
# 不是标题
[link] 不是链接
进阶语法详解
表格 (Tables)
使用 | 和 - 创建表格,可以使用 : 控制对齐方式(左对齐、居中、右对齐)。
Markdown 写法
| 姓名 | 年龄 | 职业 |
| :--- | :---: | ---: |
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
渲染效果预览
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
任务列表
使用 [ ] 和 [x] 创建待办事项列表。
Markdown 写法
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待处理事项
渲染效果预览
- ✅ 已完成任务
- ⬜ 未完成任务
- ⬜ 待处理事项
脚注
添加引用注释,在文末显示详细说明。
Markdown 写法
这是一段文字[^1]。
[^1]: 这是脚注的内容。
渲染效果预览
这是一段文字[1]
1. 这是脚注的内容。
1. 这是脚注的内容。
表情符号
使用 :emoji_name: 语法插入表情符号(GitHub 支持)。
Markdown 写法
:smile: :heart: :rocket:
:tada: :fire: :bulb:
渲染效果预览
😄 ❤️ 🚀
🎉 🔥 💡
🎉 🔥 💡
高亮文本
使用 == 标记高亮文本(部分编辑器支持)。
Markdown 写法
这是 ==高亮文本== 的示例。
渲染效果预览
这是 高亮文本 的示例。
🛠️ 工具推荐
🌐 在线编辑器
- Dillinger - 在线 Markdown 编辑器
- StackEdit - 功能丰富的在线工具
- HackMD - 协作编辑平台
- Markdown Live Preview - 轻量级预览
💻 桌面应用
- Typora - 所见即所得编辑器
- VS Code - 配合插件使用
- Obsidian - 知识管理工具
- Notion - 支持 Markdown 语法
- Mark Text - 开源免费编辑器
⌨️ 快捷键提示(VS Code)
Ctrl/Cmd + B - 加粗
Ctrl/Cmd + I - 斜体
Ctrl/Cmd + Shift + V - 预览
Ctrl/Cmd + I - 斜体
Ctrl/Cmd + Shift + V - 预览
Ctrl/Cmd + K V - 侧边预览
Alt + Shift + F - 格式化
Ctrl/Cmd + / - 注释
Alt + Shift + F - 格式化
Ctrl/Cmd + / - 注释
🎯 总结与建议
Markdown 是程序员和写作者的必备技能。它让你专注于内容本身,而不是繁琐的排版。
💡 学习建议
- 1️⃣ 多加练习:在 GitHub README、博客或笔记软件中尝试使用
- 2️⃣ 选择合适工具:使用 VS Code 或 Typora 等实时预览编辑器
- 3️⃣ 掌握基础:先熟练基础语法,再学习进阶功能
- 4️⃣ 保持简洁:Markdown 的美在于简洁,避免过度复杂化
- 5️⃣ 参考文档:随时查阅 Markdown 语法指南和示例