Markdown 语法指南：从基础到高级

Markdown 是开发者真正乐于使用的写作格式。无需点击格式化菜单，无需与所见即所得编辑器作斗争——只需在纯文本中添加一些符号，就能转换为整洁的 HTML。README 文件、文档、博客文章、聊天消息，甚至这篇文章都是用 Markdown 编写的。

使用我们的 Markdown 预览器实时预览你的 Markdown——左侧编写，右侧查看格式化输出。

基础语法

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

层次化使用标题。不要跳级（从 H1 直接到 H3）——这会影响可读性和无障碍性。

强调

*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体***
~~删除线~~

链接和图片

[链接文本](https://example.com)
[带标题的链接](https://example.com "标题")
![替代文本](image.png)

列表

- 无序列表项
- 另一个列表项
  - 嵌套列表项

1. 第一项
2. 第二项
3. 第三项

引用块

> 这是一个引用块。
> 它可以跨越多行。

代码

行内代码

使用反引号表示行内代码：`const x = 42`

代码块

使用三个反引号和可选的语言标识符：

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

支持的语言包括 javascript、python、json、yaml、html、css、bash 等。

表格

| 表头 1 | 表头 2 | 表头 3 |
|--------|--------|--------|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |

对齐方式：

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 左     |  中  |     右 |

高级语法

任务列表

- [x] 已完成的任务
- [ ] 待办任务
- [ ] 另一个任务

脚注

这里有一个声明[^1]。

[^1]: 这是脚注内容。

定义列表

术语
: 术语的定义

水平线

---
***
___

GitHub 风格 Markdown (GFM)

GitHub 用实用的功能扩展了标准 Markdown：

自动链接 URL — 裸 URL 自动变成可点击的链接
任务列表 — Issue 和 PR 中的复选框
表格 — 上面展示的管道语法
删除线 — ~~删除的文本~~
语法高亮 — 特定语言的代码着色
Emoji — :smile: 变成笑脸表情

写作技巧

段落保持简短——最多 3-5 句话
使用标题创建可扫描的结构
步骤或功能特性优先使用列表而非长段落
讨论技术概念时添加代码示例
经常预览——我们的 Markdown 预览器会在你输入时显示输出

常见问题

Markdown 和 HTML 有什么区别？

Markdown 是一种简化的写作格式，可以转换为 HTML。它用更少的语法满足了最常见的格式化需求。当你需要 Markdown 不支持的功能时，可以在 Markdown 中嵌入原始 HTML。

我应该使用哪种 Markdown 方言？

GitHub 风格 Markdown (GFM) 是支持最广泛的。它在标准 Markdown 的基础上增加了表格、任务列表和删除线。CommonMark 是标准化规范。

Markdown 可以用于文档编写吗？

当然可以。Markdown 是 README 文件、Wiki 和文档网站的标准。MkDocs、Docusaurus 和 GitBook 等工具都使用 Markdown。