本指南旨在全面介绍 Hugo 博客系统所支持的 Markdown 语法。Markdown 是一种轻量级的标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML。对于内容创作者而言,熟练掌握 Markdown 能够极大地提高内容创作的效率和便捷性。
1. 标题 (Headings)
Markdown 使用 # 号来表示标题的级别,从一级标题到六级标题。
# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)
渲染效果:
一级标题 (H1)
二级标题 (H2)
三级标题 (H3)
四级标题 (H4)
五级标题 (H5)
六级标题 (H6)
2. 段落 (Paragraphs)
段落是由一个或多个连续的文本行组成的。段落之间需要用一个或多个空行来分隔。
渲染效果: 这是一个段落。段落之间用空行分隔。
这是另一个段落。
3. 强调 (Emphasis)
Markdown 支持两种强调方式:斜体和粗体。
- 斜体 (Italic): 使用一个星号
*或下划线_包裹文本。 - 粗体 (Bold): 使用两个星号
**或下划线__包裹文本。 - 粗斜体 (Bold Italic): 使用三个星号
***或下划线___包裹文本。
*这是斜体*
_这也是斜体_
**这是粗体**
__这也是粗体__
***这是粗斜体***
___这也是粗斜体___
渲染效果: 这是斜体 这也是斜体
这是粗体 这也是粗体
这是粗斜体 这也是粗斜体
4. 列表 (Lists)
Markdown 支持无序列表和有序列表。
4.1. 无序列表 (Unordered Lists)
使用星号 *、加号 + 或减号 - 来创建无序列表。
* 项目一
* 项目二
* 子项目 2.1
* 子项目 2.2
* 项目三
渲染效果:
- 项目一
- 项目二
- 子项目 2.1
- 子项目 2.2
- 项目三
4.2. 有序列表 (Ordered Lists)
使用数字后跟一个英文句点 . 来创建有序列表。
1. 第一项
2. 第二项
1. 子项 2.1
2. 子项 2.2
3. 第三项
渲染效果:
- 第一项
- 第二项
- 子项 2.1
- 子项 2.2
- 第三项
5. 链接 (Links)
Markdown 支持内联链接和参考式链接。
5.1. 内联链接 (Inline Links)
格式为 [链接文本](URL "可选的标题")。
[访问世界杯官网](https://www.fifa.com/fifa-world-cup "FIFA World Cup Official Site")
渲染效果: 访问世界杯官网
5.2. 参考式链接 (Reference-style Links)
这种方式可以将 URL 和标题放在文档的其他地方,使文本更整洁。
这是一个参考式链接:[谷歌][google]
[google]: https://www.google.com "Google Search"
渲染效果: 这是一个参考式链接:[谷歌]
6. 图片 (Images)
图片语法与链接类似,只是前面多一个感叹号 !。
格式为 。

渲染效果:

7. 代码块 (Code Blocks)
Markdown 支持行内代码和代码块。
7.1. 行内代码 (Inline Code)
使用反引号 ` 包裹代码。
在 JavaScript 中,`console.log()` 用于输出信息。
渲染效果:
在 JavaScript 中,console.log() 用于输出信息。
7.2. 代码块 (Code Blocks)
使用三个反引号 来创建代码块,可以指定语言高亮。
```python
def hello_world():
print("Hello, World!")
hello_world()
**渲染效果:**
```python
def hello_world():
print("Hello, World!")
hello_world()
8. 引用 (Blockquotes)
使用大于号 > 来创建引用块。
> 这是引用内容。
> 引用可以包含多个段落。
>
> > 嵌套引用也是支持的。
渲染效果:
这是引用内容。 引用可以包含多个段落。
嵌套引用也是支持的。
9. 分隔线 (Horizontal Rules)
可以使用三个或更多的星号 ***、减号 --- 或下划线 ___ 来创建水平分隔线。
---
渲染效果:
10. 表格 (Tables)
Markdown 支持创建表格,但语法相对复杂一些。
| 列头 1 | 列头 2 | 列头 3 |
| :------ | :----: | ------: |
| 左对齐 | 居中 | 右对齐 |
| 内容 A | 内容 B | 内容 C |
| 更多 | 示例 | 数据 |
渲染效果:
| 列头 1 | 列头 2 | 列头 3 |
|---|---|---|
| 左对齐 | 居中 | 右对齐 |
| 内容 A | 内容 B | 内容 C |
| 更多 | 示例 | 数据 |
11. 任务列表 (Task Lists)
在 Markdown 中可以创建带有复选框的列表项。
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个未完成项
渲染效果:
- 已完成的任务
- 未完成的任务
- 另一个未完成项
掌握这些 Markdown 语法,将使您在世界杯赛事平台的内容创作过程中更加得心应手,能够清晰、结构化地呈现各类信息,无论是赛事报道、球队分析还是用户指南。