Markdown语法速查

Markdown是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换为结构化的HTML文档。Hugo广泛支持Markdown，并在此基础上提供了一些扩展。掌握Markdown语法是使用Hugo进行内容创作的基础。

标题 (Headings)

使用井号 # 来创建标题，井号的数量决定了标题的级别。

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

段落 (Paragraphs)

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

这是第一个段落。

这是第二个段落。
它包含多行文本，但会被Hugo渲染成一个段落。

强调 (Emphasis)

• 粗体 (Bold): 使用两个星号 ** 或下划线 __ 包围文本。 **加粗文本** 或 __加粗文本__
• 斜体 (Italic): 使用一个星号 * 或下划线 _ 包围文本。 *斜体文本* 或 _斜体文本_
• 粗斜体 (Bold Italic): 结合使用。 ***粗斜体文本*** 或 ___粗斜体文本___

列表 (Lists)

• 无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 作为列表项前缀。

  * 项目一
  * 项目二
    * 子项目二点一
    * 子项目二点二
  + 项目三
  

• 有序列表 (Ordered Lists): 使用数字加点 1. 作为列表项前缀。数字的顺序不严格要求，Hugo会自动排序。

  1. 第一步
  2. 第二步
     1. 子步骤二点一
     2. 子步骤二点二
  3. 第三步
  

链接 (Links)

• 行内链接 (Inline Links):

  这是一个 [行内链接](https://www.example.com "这是一个提示")。
  

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

  我需要去 [Google][1] 搜索信息。
  或者去 [世界杯官网][worldcup]。
  
  [1]: https://www.google.com
  [worldcup]: https://www.fifa.com/worldcup/
  

图片 (Images)

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

• 行内图片:

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

• 参考式图片:

  ![世界杯Logo][logo]
  
  [logo]: /images/worldcup-logo.png "2026世界杯官方Logo"
  

代码 (Code)

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

  在Go语言中，使用 `fmt.Println()` 函数打印输出。
  

• 代码块 (Code Blocks): 使用三个反引号 ``` 包围代码块。您可以指定语言高亮。

  ```go
  package main
  
  import "fmt"
  
  func main() {
      fmt.Println("Hello, World!")
  }
  

引用 (Blockquotes)

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

> 这是引用内容。
> 引用可以包含多行。
> > 嵌套引用也是支持的。

水平分割线 (Horizontal Rules)

使用三个或更多的星号 ***、减号 --- 或下划线 `