本文涵盖了所有基础 Markdown 语法，帮助你编写丰富、结构清晰的内容。每个功能都附带可用的示例，让你直观地看到渲染效果。

标题

Markdown 支持六个级别的标题，使用 # 符号来定义标题层级。

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

每个标题会自动生成锚点链接，这也是上面目录能够跳转的原理。为了无障碍访问，请勿跳过标题层级——应从 h2 到 h3，而不是从 h2 直接到 h5。

文本格式

Markdown 提供多种内联格式选项：

语法	效果
`粗体文本`	粗体文本
`斜体文本`	斜体文本
`~~删除线~~`	~~删除线~~
`_粗斜体_`	*粗斜体*
`行内代码`	`行内代码`
`<mark>高亮文本</mark>`	高亮文本
`<sup>上标</sup>`	x²
`<sub>下标</sub>`	H₂O

你可以自由组合这些格式：

这是 粗体与斜体 的混合使用，出现在一句话中。
这段文字有 ~~被删除的部分~~ 和 替换内容。
在 粗体上下文 中使用 行内代码：config.ts 配置文件。

列表

无序列表

使用 -、* 或 + 创建无序列表：

第一项
第二项
第三项
- 嵌套项 A
- 嵌套项 B
  - 深层嵌套项
  - 另一个深层嵌套项
- 嵌套项 C
第四项

有序列表

使用数字加句点创建有序列表：

第一步
第二步
第三步
1. 子步骤 3a
2. 子步骤 3b
  1. 子子步骤
  2. 另一个子子步骤
3. 子步骤 3c
第四步

混合列表

你可以将有序列表嵌套在无序列表中，反之亦然：

项目搭建
1. 初始化仓库
2. 安装依赖
3. 配置环境
开发阶段
1. 创建组件
2. 编写测试
3. 代码审查
部署上线
1. 构建项目
2. 运行测试
3. 部署到生产环境

包含段落的列表

列表项可以通过缩进包含多个段落：

第一项，附带详细描述。

这是第一项下的续接段落。注意空行和缩进的使用方式。
第二项。

这里是另一个段落。正确缩进后，列表项可以包含任何块级内容。

链接与图片

内联链接

访问 Astro 官方网站了解更多关于这个框架的信息。

你也可以添加标题属性：Astro 文档。

引用式链接

为了保持文本整洁，可以使用引用式链接：

阅读 Astro 指南或查看 Tailwind 文档了解样式方案。

自动链接

直接粘贴 URL 即可变为可点击的链接：https://github.com

图片

标准图片语法：

宁静的山景

带标题的图片：

屏幕上的代码

带链接的图片

引用

简单引用

Markdown 是一种轻量级标记语言，使用纯文本格式语法。它由 John Gruber 于 2004 年创建。

多段落引用

引用的第一段。

引用的第二段。在段落之间的空行上使用 > 以保持在同一个引用块中。

嵌套引用

这是外层引用。

这是嵌套引用，深入一层。

这里嵌套了三层！

回到第一层。

包含其他元素的引用

引用中的标题

第一项

第二项

引用可以包含粗体、斜体和 代码 格式，以及列表和其他 Markdown 元素。

分割线

你可以使用三个或更多的连字符、星号或下划线创建分割线：

三种方式渲染效果完全相同。使用它们来对内容进行视觉分隔。

表格

简单表格

姓名	角色	所在地
Alice	前端开发	东京
Bob	后端开发	柏林
Carol	DevOps 工程师	纽约

对齐表格

使用冒号控制列对齐方式：

左对齐	居中对齐	右对齐
内容	内容	内容
更多	更多	更多
文本	文本	文本

复杂表格

功能	免费版	专业版	企业版
用户数	1	10	无限制
存储空间	1 GB	100 GB	1 TB
API 调用	1,000次/月	100,000次/月	无限制
技术支持	社区	邮件	7×24 电话
SSO 单点登录	❌	❌	✅
自定义域名	❌	✅	✅
数据分析	基础	高级	高级

带格式的表格

方法	描述	示例
`GET`	获取资源	`fetch('/api/users')`
`POST`	创建新资源	`fetch('/api/users', { method: 'POST' })`
`PUT`	更新资源	`fetch('/api/users/1', { method: 'PUT' })`
`DELETE`	删除资源	`fetch('/api/users/1', { method: 'DELETE' })`

任务列表

任务列表（复选框）非常适合追踪进度：

嵌套任务列表

脚注

脚注可以添加参考信息而不打乱正文阅读。

Markdown 由 John Gruber¹ 和 Aaron Swartz² 于 2004 年创建。此后它成为了网络上最流行的标记语言之一³。

最初的 Markdown 规范¹有意保持简洁。许多扩展语法如 GitHub Flavored Markdown（GFM）⁴在原始规范基础上进行了扩展。

Emoji 表情

你可以在 Markdown 中使用 emoji 短代码：

🚀 发布日！
⭐ 精选内容
:book: 文档
💡 每日技巧
⚠️ 重要通知
✔️ 任务完成
❌ 测试失败
❤️ 社区之爱
🎉 庆祝时刻
🚧 施工中

上下文中的 Emoji

💡 提示： 在技术写作中应适度使用 emoji。它们非常适合状态指示和轻松风格的博客文章。

以下是一个快速项目状态概览：

任务	状态
后端 API	✔️ 已完成
前端 UI	🚧 进行中
文档	:book: 编写中
测试	❌ 未开始
部署	🚀 就绪

总结

本文涵盖了你日常使用的核心 Markdown 语法。Markdown 的简洁性正是它的优势——几个简单的符号就能将纯文本转换为丰富的结构化文档。如需了解数学公式、代码高亮和告警提示等更高级的功能，请参阅 Markdown 扩展功能一文。

John Gruber 是一位技术博客作者，也是 Daring Fireball 博客的创建者。 ↩ ↩²
Aaron Swartz 是一位程序员、作家和互联网活动家，他为 Markdown 规范做出了贡献。 ↩
根据各项开发者调查，Markdown 是最常用的文档格式。 ↩
GitHub Flavored Markdown（GFM）在原始规范基础上添加了表格、任务列表、删除线和自动链接。 ↩

Markdown 基础：完整语法指南

目录

标题