Markdown 语法指南

Markdown 是一种轻量级的标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)。由于其简洁的语法,Markdown 被广泛应用于博客、技术文档、笔记等场景。Hugo 作为一款静态网站生成器,对 Markdown 提供了强大的支持,使得内容创作变得更加便捷高效。

标题 (Headings)

Markdown 使用 # 号来表示标题的层级,一个 # 代表一级标题,两个 # 代表二级标题,依此类推,最多支持六级标题。

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

段落 (Paragraphs)

段落之间用一个或多个空行隔开。

这是第一个段落。

这是第二个段落。

强调 (Emphasis)

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

列表 (Lists)

无序列表 (Unordered Lists)

使用星号 *、加号 + 或减号 - 作为列表项的标记,可以嵌套使用。

* 第一项
* 第二项
  * 第二项的子项 A
  * 第二项的子项 B
* 第三项

- 第一项
- 第二项

+ 第一项
+ 第二项

有序列表 (Ordered Lists)

使用数字加英文句点 . 作为列表项的标记,数字的顺序可以不连续,Markdown 会自动处理。

1. 第一步
2. 第二步
   1. 第二步的子步骤 A
   2. 第二步的子步骤 B
3. 第三步

Markdown 的链接语法非常直观。

  • 行内链接 (Inline Links)[链接文本](链接地址 "可选的标题") 例如:[访问 2026世界杯直播官网](https://example.com "2026世界杯直播官网")

  • 参考链接 (Reference-style Links): 在文本中插入一个标签,然后在文档的其他地方定义这个标签。

    文本中的链接:[这是一个参考链接][reference] 标签定义:

    [reference]: https://example.com "可选的标题"
    

    或者

    [reference]: https://example.com
    "可选的标题"
    

图片 (Images)

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

  • 行内图片 (Inline Images)![图片替代文本](图片地址 "可选的标题") 例如:![世界杯 Logo](/uploads/content/321211ecc3f95ed7.png "世界杯官方 Logo")

  • 参考图片 (Reference-style Images)![这是一个参考图片][image-ref] 标签定义:

    [image-ref]: https://example.com/image.jpg "可选的标题"
    

代码 (Code)

  • 行内代码 (Inline Code):使用反引号 ` 包围代码片段。 例如:var myVariable = "hello";

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

    ```javascript
    function greet(name) {
      console.log("Hello, " + name + "!");
    }
    greet("World");
    ```
    

引用 (Blockquotes)

使用 > 符号表示引用,可以嵌套使用。

> 这是第一层引用。
>
> > 这是第二层引用。
>
> 回到第一层。

水平分割线 (Horizontal Rules)

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

***

---

___

表格 (Tables)

Markdown 支持表格,使用管道符 | 分隔单元格,使用连字符 - 分隔表头和表体。冒号 : 可以用来控制对齐方式。

| 表头 1 | 表头 2 | 表头 3 |
| :----- | :----: | -----: |
| 左对齐 |  居中  | 右对齐 |
| 数据 A | 数据 B | 数据 C |
| 数据 D | 数据 E | 数据 F |

其他常用语法

  • 删除线 (Strikethrough):使用两个波浪号 ~~ 包围文本。 ~~被删除的文本~~

  • 任务列表 (Task Lists):在列表项中使用 [ ] 表示未完成,[x] 表示已完成。

    - [x] 完成博客文章
    - [ ] 优化图片资源
    - [x] 检查链接有效性
    

通过熟练掌握以上 Markdown 语法,您可以更专注于内容的创作本身,而无需担心复杂的排版问题。Hugo 将会自动将您的 Markdown 文档渲染成美观且结构化的网页。