本指南旨在全面介绍 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. 第三项

渲染效果:

  1. 第一项
  2. 第二项
    1. 子项 2.1
    2. 子项 2.2
  3. 第三项

Markdown 支持内联链接和参考式链接。

格式为 [链接文本](URL "可选的标题")

[访问世界杯官网](https://www.fifa.com/fifa-world-cup "FIFA World Cup Official Site")

渲染效果: 访问世界杯官网

这种方式可以将 URL 和标题放在文档的其他地方,使文本更整洁。

这是一个参考式链接:[谷歌][google]

[google]: https://www.google.com "Google Search"

渲染效果: 这是一个参考式链接:[谷歌]

6. 图片 (Images)

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

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

![世界杯 Logo](/images/worldcup-logo.png "世界杯 Logo")

渲染效果: 世界杯 Logo

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 语法,将使您在世界杯赛事平台的内容创作过程中更加得心应手,能够清晰、结构化地呈现各类信息,无论是赛事报道、球队分析还是用户指南。