Markdown 语法详解：轻松掌握内容创作
技术指南 markdown hugo syntax writing guide
Published: 2026-05-21

Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。在 Hugo 博客的创作流程中，Markdown 是您日常编写内容的基础工具。掌握 Markdown 语法，不仅能极大地提高您的写作效率，还能确保内容的结构化和格式化，使其在不同平台都能良好地呈现。

标题 (Headings)

Markdown 使用 # 号来创建标题，# 的数量代表了标题的级别。一级标题（#）通常用于文章的整体标题，而后续的二级（##）、三级（###）标题则用于组织文章结构。

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

段落与换行 (Paragraphs and Line Breaks)

Markdown 中的段落由一个或多个连续的文本行组成，段落之间用一个或多个空行分隔。如果您需要在段落内强制换行，可以在行末添加两个或更多空格，然后回车。

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

这是一个新的段落。
  
  
这是另一段。

这是最后一段。

强调 (Emphasis)

您可以使用星号 * 或下划线 _ 来创建斜体和粗体文本。

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

列表 (Lists)

Markdown 支持有序列表和无序列表。

  • 无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 来创建。
    * 项目一
* 项目二
  * 子项目 2.1
  * 子项目 2.2
- 项目三
  • 有序列表 (Ordered Lists): 使用数字后跟一个英文句点。
    1. 第一步
2. 第二步
   1. 子步骤 2.1
   2. 子步骤 2.2
3. 第三步

Markdown 链接的语法是 [链接文本](URL)。您可以选择性地添加一个 title 属性，该属性会在用户将鼠标悬停在链接上时显示。

这是指向 [世界杯官方网站](https://www.fifa.com/worldcup "官方世界杯网站") 的链接。

图片 (Images)

图片的语法与链接类似，但前面多一个感叹号 !。语法是 ![图片替代文本](图片URL)。

![世界杯Logo](/uploads/content/552a303c20cb6be5.png "世界杯标志")

代码 (Code)

  • 行内代码 (Inline Code): 使用反引号 ` 包围。
    在 Hugo 中，您可以使用 `hugo new post/my-new-post.md` 命令创建新文章。
  • 代码块 (Code Blocks): 使用三个反引号 ``` 包围，并可以指定语言高亮。
    ```go
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

引用 (Blockquotes)

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

> 这是引用文本。
> 它可以包含多个段落。
>
> > 嵌套引用也是支持的。

分隔线 (Horizontal Rules)

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

---

表格 (Tables)

Markdown 也可以用来创建表格，这对于展示世界杯赛事数据、球队统计等信息非常有用。

| 球队   | 胜 | 平 | 负 | 积分 |
| :----- | :-: | :-: | :-: | :-: |
| 巴西   | 3  | 0  | 0  | 9  |
| 阿根廷 | 2  | 1  | 0  | 7  |
| 法国   | 1  | 1  | 1  | 4  |

表格的对齐方式通过冒号 : 来控制：左对齐（:---）、居中对齐（:---:）或右对齐（---:）。

HTML 嵌入

Hugo 允许您在 Markdown 文件中直接嵌入 HTML 代码。这为您提供了更大的灵活性，可以实现 Markdown 本身无法完成的复杂布局或交互。

<p>这是一个直接嵌入的 <strong>HTML</strong> 段落。</p>
<div style="background-color: #f0f0f0; padding: 10px;">
    这是一个带有样式的 div 块。
</div>

注意事项

  • 空行： 在 Markdown 中，空行起着非常重要的作用，尤其是在分隔段落、列表项和代码块时。
  • 转义字符： 如果您想显示 Markdown 中的特殊字符本身，而不是让它们被解析，可以使用反斜杠 \ 进行转义，例如 \* 会显示为一个星号。
  • Hugo 主题： 不同的 Hugo 主题可能对 Markdown 的某些扩展语法（如表格、任务列表等）有不同的支持程度。在使用时，建议查阅您所使用主题的文档。

熟练运用以上 Markdown 语法，您将能更加高效地在世界杯（WorldCup）赛事中心博客上发布包含丰富格式和结构的精彩内容，为您的读者提供更佳的阅读体验。