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. 第三步
链接 (Links)
Markdown 的链接语法非常直观。
行内链接 (Inline Links):
[链接文本](链接地址 "可选的标题")例如:[访问 2026世界杯直播官网](https://example.com "2026世界杯直播官网")参考链接 (Reference-style Links): 在文本中插入一个标签,然后在文档的其他地方定义这个标签。
文本中的链接:
[这是一个参考链接][reference]标签定义:[reference]: https://example.com "可选的标题"或者
[reference]: https://example.com "可选的标题"
图片 (Images)
图片语法与链接类似,只是前面多一个感叹号 !。
行内图片 (Inline Images):
例如:参考图片 (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 文档渲染成美观且结构化的网页。