Markdown 语法指南

May 5, 2026 · 8 mins read

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。Markdown 的设计哲学是“易读易写”，这使得它在内容创作领域，尤其是在博客、文档编写和在线论坛中得到了广泛应用。Wepoker 平台在内容管理和展示时，也遵循了 Markdown 的标准，为您提供了一个清晰、简洁的内容创作环境。

为什么要使用 Markdown？

易读性： Markdown 的语法非常直观，即使不经过渲染，也能大致理解文档的内容。
易写性： 相比于 HTML，Markdown 的语法更简单，输入更快捷。
跨平台兼容性： Markdown 文件是纯文本，可以在任何操作系统和文本编辑器中打开和编辑。
易于转换为其他格式： 许多工具可以将 Markdown 文件转换为 HTML、PDF、Word 文档等多种格式。
适合内容创作： 专注于内容本身，而不是格式的排版。

Markdown 基础语法：

以下是一些 Markdown 最常用的语法元素：

1. 标题 (Headings)

使用 # 号来创建标题，# 的数量表示标题的级别。

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

2. 段落 (Paragraphs)

段落之间用一个或多个空行隔开。

这是第一个段落。

这是第二个段落。

3. 强调 (Emphasis)

粗体 (Bold)： 使用两个星号 ** 或两个下划线 __ 包围文本。
```
**这是粗体文本**
__这也是粗体文本__
```
斜体 (Italic)： 使用一个星号 * 或一个下划线 _ 包围文本。
```
*这是斜体文本*
_这也是斜体文本_
```

粗斜体 (Bold Italic)： 结合使用。

***这是粗斜体文本***
___这也是粗斜体文本___

4. 列表 (Lists)

无序列表 (Unordered Lists)： 使用星号 *、加号 + 或减号 - 开头，后面跟一个空格。
```
* 列表项一
* 列表项二
  * 嵌套列表项
+ 列表项三
- 列表项四
```
有序列表 (Ordered Lists)： 使用数字加英文句点 . 开头，后面跟一个空格。数字的顺序不一定需要连续，Markdown 会自动处理。
```
1. 第一项
2. 第二项
   1. 嵌套第一项
3. 第三项
```

5. 链接 (Links)

行内链接 (Inline Links)： [链接文本](URL "可选的标题")

访问 [Wepoker 官网](https://www.wepoker.com) 获取更多信息。

参考式链接 (Reference-style Links)：

这是一个参考式链接：[Wepoker 官网][wepoker-link]。

[wepoker-link]: https://www.wepoker.com "Wepoker 官方网站"

6. 图片 (Images)

语法与链接类似，只是在方括号前多一个感叹号 !。

行内图片 (Inline Images)： ![替代文本](图片URL "可选的标题")
```
![Wepoker Logo](images/wepoker-logo.png "Wepoker Logo")
```

参考式图片 (Reference-style Images)：

![Wepoker Logo][logo]

[logo]: images/wepoker-logo.png "Wepoker Logo"

7. 代码 (Code)

行内代码 (Inline Code)： 使用反引号 ` 包围代码。
```
请在代码中输入 `wpk_command`。
```
代码块 (Code Blocks)： 使用三个反引号包围多行代码。可以指定语言高亮。
```
```python
def hello_world():
    print("Hello, Wepoker!")
```

8. 引用 (Blockquotes)

使用大于号 > 开头。

> 这是引用的内容。
>
> > 嵌套的引用。

9. 分隔线 (Horizontal Rules)

使用三个或更多星号 *、减号 - 或下划线 _ 来创建分隔线。

***

---

___

10. 表格 (Tables)

Markdown 的表格语法相对复杂一些，但非常实用。

| 列标题 1 | 列标题 2 | 列标题 3 |
| :------- | :------: | -------: |
| 左对齐   |  居中对齐 | 右对齐   |
| 内容     |  示例    | 文本     |

: 用来控制对齐方式：左对齐、居中对齐、右对齐。

Markdown 的进阶用法：

除了上述基础语法，Markdown 还有一些扩展功能，例如：

任务列表 (Task Lists)：

- [x] 已完成的任务
- [ ] 未完成的任务

Footnotes (脚注)：

这是一个带有脚注的句子[^1]。

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

掌握 Markdown 语法，能够极大地提高您在 Wepoker 平台或其他支持 Markdown 的环境中进行内容创作的效率和便捷性。希望这份指南对您有所帮助！