Markdown Guide快速参考手册：最实用的语法速查表

Markdown是一种轻量级标记语言，让你可以使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。本指南将帮助你快速掌握最实用的Markdown语法，无论是撰写文档、博客还是README文件都能轻松应对。

为什么选择Markdown？

Markdown语法简洁直观，学习成本低，却能满足大部分文档编写需求。它被广泛应用于GitHub、GitLab等代码托管平台，也是许多写作工具和内容管理系统的首选格式。掌握Markdown可以让你更专注于内容创作，而不必分心于复杂的格式设置。

基础语法速查表

以下是所有Markdown应用都支持的基础语法元素，是你日常使用最频繁的核心功能：

元素	Markdown语法
标题	# H1 ## H2 ### H3
粗体	**粗体文本**
斜体	*斜体文本*
引用块	> 这是一个引用块
有序列表	1. 第一项 2. 第二项 3. 第三项
无序列表	- 第一项 - 第二项 - 第三项
代码	`代码`
分割线	---
链接	[链接文本](https://example.com)
图片	替代文本

扩展语法实用技巧

这些扩展语法元素能让你的文档更丰富，但请注意不是所有Markdown应用都支持：

表格

创建清晰的表格来展示数据：

| 语法 | 描述 |
|------|------|
| 标题 | 标题文本 |
| 段落 | 普通文本 |

代码块

展示代码片段并支持语法高亮：

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

任务列表

创建可勾选的任务清单：

• [x] 完成基础语法学习
• [ ] 实践扩展语法
• [ ] 创作一篇Markdown文档

其他实用元素

• 删除线：~~需要删除的文本~~
• 脚注：这里有一个脚注[^1]
[^1]: 脚注内容
• 表情符号：:smile: 😊
• 高亮文本：==需要高亮的文本==
• 上标/下标：X^2^ H~2~O

如何开始使用Markdown？

1. 选择一个Markdown编辑器，如Typora、VS Code或在线工具Dillinger
2. 学习基础语法（本指南已涵盖）
3. 开始编写并实时预览效果
4. 根据需要学习和使用扩展语法

学习资源

• 完整语法指南：_basic-syntax/overview.md
• 扩展语法详情：_extended-syntax/overview.md
• 可下载的速查表：assets/markdown-cheat-sheet.md

掌握这些Markdown语法，你就能轻松创建格式优美的文档了。无论是技术文档、博客文章还是项目说明，Markdown都能让你的内容创作变得简单高效！

想要获取完整的Markdown指南资源，可以通过以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/ma/markdown-guide