Markdown 语法速查指南

Apr 25, 2026 · 11 mins read
Markdown 教程 Hugo 写作
Markdown 语法速查指南

Markdown是一种轻量级的标记语言，以其简洁的语法和易于读写的特点，在互联网内容创作领域得到了广泛的应用。无论是撰写博客文章、技术文档，还是在社交媒体上发布内容，Markdown都能帮助你快速、高效地格式化文本。Hugo作为一款流行的静态网站生成器，默认支持Markdown，这使得使用Markdown来构建网站内容变得非常方便。

本指南将为您提供一个Markdown语法速查，帮助您快速掌握常用的Markdown格式。

1. 标题 (Headings)

Markdown支持六级标题，使用井号#来表示。井号的数量决定了标题的级别。

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

渲染效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 段落与换行 (Paragraphs and Line Breaks)

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

要强制换行（不产生新的段落），可以在行末使用两个或多个空格，然后按回车键。

这是第一段。

这是第二段。

这是第一行。  
这是第二行（强制换行）。

渲染效果：

这是第一段。

这是第二段。

这是第一行。 这是第二行（强制换行）。

3. 强调 (Emphasis)

Markdown提供了两种强调方式：斜体和粗体。

  • 斜体 (Italic): 使用一个星号*或下划线_包裹文本。
  • 粗体 (Bold): 使用两个星号**或下划线__包裹文本。
  • 粗斜体 (Bold Italic): 使用三个星号***或下划线___包裹文本。
*这是斜体*
_这也是斜体_

**这是粗体**
__这也是粗体__

***这是粗斜体***
___这也是粗斜体___

渲染效果：

这是斜体 这也是斜体

这是粗体 这也是粗体

这是粗斜体 这也是粗斜体

4. 列表 (Lists)

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

4.1 无序列表 (Unordered Lists)

使用星号*、加号+或减号-作为列表项的标记，标记后跟一个空格。

* 项目一
* 项目二
  * 子项目 A
  * 子项目 B
+ 项目三
- 项目四

渲染效果：

  • 项目一
  • 项目二
    • 子项目 A
    • 子项目 B
  • 项目三
  • 项目四

4.2 有序列表 (Ordered Lists)

使用数字后跟一个点.作为列表项的标记，数字的顺序不必严格按照1, 2, 3…，Markdown会自动排序。

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

渲染效果：

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

Markdown链接有两种形式：行内链接和参考式链接。

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

访问 [2026世界杯官方中文网](https://www.example2026worldcup.com "世界杯官网") 获取最新资讯。

渲染效果：

访问 2026世界杯官方中文网 获取最新资讯。

这种方式允许你将URL和标题定义在文档的其他地方，使文本更简洁。

这是一个[参考式链接][id]。

[id]: https://www.example2026worldcup.com "世界杯官网"

渲染效果：

这是一个参考式链接。

6. 图片 (Images)

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

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

![世界杯 Logo](https://www.example2026worldcup.com/logo.png "2026世界杯Logo")

渲染效果：

世界杯 Logo

7. 代码 (Code)

7.1 行内代码 (Inline Code)

使用反引号 ` 包裹代码。

在Markdown中使用 `<h1>` 标签可以创建一级标题。

渲染效果：

在Markdown中使用 <h1> 标签可以创建一级标题。

7.2 代码块 (Code Blocks)

使用三个反引号 包裹代码块，并可以指定语言高亮。

```html
<!DOCTYPE html>
<html>
<head>
    <title>示例页面</title>
</head>
<body>
    <h1>你好，世界！</h1>
</body>
</html>


**渲染效果：**

```html
<!DOCTYPE html>
<html>
<head>
    <title>示例页面</title>
</head>
<body>
    <h1>你好，世界！</h1>
</body>
</html>

8. 引用 (Blockquotes)

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

> 这是引用内容。
> 它可以包含多行。
> 也可以嵌套其他Markdown元素。

渲染效果：

这是引用内容。 它可以包含多行。 也可以嵌套其他Markdown元素。

9. 分割线 (Horizontal Rules)

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

---

渲染效果：

10. 表格 (Tables)

Markdown表格的语法如下：

| 列标题1 | 列标题2 | 列标题3 |
| :------ | :----: | ------: |
| 左对齐  | 居中对齐 | 右对齐  |
| 数据A   | 数据B   | 数据C   |

渲染效果：

列标题1列标题2列标题3
左对齐居中对齐右对齐
数据A数据B数据C
  • 冒号 : 用于指定文本对齐方式：:--- 表示左对齐，:---: 表示居中对齐，---: 表示右对齐。
  • 分隔符 | 用于分隔单元格。

11. 删除线 (Strikethrough)

使用两个波浪线~~包裹文本。

~~这是被删除的文本~~

渲染效果：

这是被删除的文本

12. 任务列表 (Task Lists)

在列表项中使用[ ]表示未完成的任务，[x]表示已完成的任务。

- [x] 完成世界杯官网内容更新
- [ ] 优化比分直播接口
- [ ] 撰写赛事分析文章

渲染效果：

  • 完成世界杯官网内容更新
  • 优化比分直播接口
  • 撰写赛事分析文章

掌握这些基本的Markdown语法，将极大地提升您在Hugo等平台上的内容创作效率。无论是发布关于2026世界杯赛程的资讯，还是撰写技术教程，Markdown都能让您的内容更加结构化和易于阅读。

Sharing is caring!