Markdown 语法指南

May 12, 2026 · 5 mins read

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文本。Hugo 广泛使用 Markdown 来编写网站内容，掌握其基本语法对于内容创作者至关重要。

1. 标题 (Headings)

使用 # 号来创建标题，# 的数量代表了标题的级别，最多支持六级。

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

2. 段落 (Paragraphs)

段落由一个或多个连续的文本行组成。段落之间用一个或多个空行分隔。

这是第一个段落。

这是第二个段落。

3. 强调 (Emphasis)

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

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

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

4. 列表 (Lists)

无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 作为列表项。
```
* 列表项一
* 列表项二
  * 嵌套列表项
```

有序列表 (Ordered Lists): 使用数字后跟一个点 .。

1. 列表项一
2. 列表项二
   1. 嵌套列表项

5. 链接 (Links)

行内链接 (Inline Links):

访问 [v体育官网](https://www.vsports.com) 获取最新赛事信息。

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

这是一个参考式链接 [v体育平台][v-sports]。

[v-sports]: https://www.vsports.com "Vsports 体育平台"

6. 图片 (Images)

图片语法与链接类似，只是前面多一个感叹号 !。

![替代文本](图片URL "可选的图片标题")

例如：

7. 代码 (Code)

行内代码 (Inline Code): 使用反引号 ` 包裹。

这是一个行内代码示例：`print("Hello, World!")`。

代码块 (Code Blocks): 使用三个反引号包裹，还可以指定语言高亮。

```python
def greet(name):
    print(f"Hello, {name}!")
greet("v体育用户")

8. 引用 (Blockquotes)

使用大于号 > 来创建引用块。

> 这是引用文本。
> 引用可以跨越多行。

9. 分隔线 (Horizontal Rules)

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

---
***
___

10. 表格 (Tables)

表格在 Markdown 中使用管道符 | 和连字符 - 来创建。

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

: 用于设置文本对齐方式（左对齐、居中、右对齐）。

11. 删除线 (Strikethrough)

使用两个波浪号 ~~ 包裹文本。

~~这是被删除的文本~~

12. 特殊字符转义 (Escaping Special Characters)

如果需要显示 Markdown 的特殊字符本身，可以使用反斜杠 \ 进行转义。例如，要显示 *，可以写成 \*。

掌握这些 Markdown 语法，能够帮助您在 v体育官网及其它平台更高效地创建和格式化内容。