Markdown语法总结
Markdown 是一种轻量级的标记语言,它让我们可以以易读易写的纯文本格式编写文档,然后转换为有效的 HTML。它广泛应用于撰写文档、博客、论坛帖子以及各种需要格式化文本的场合。以下是我准备的 Markdown 语法的详细总结:
1. 标题 (Headers)
使用 #
来表示不同级别的标题,共有六级标题。
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
段落由一个或多个空行分隔。行末加两个或以上空格后回车可实现换行。
这是第一段。这是第二段,可以在这里加换行。 这是同一段的新行。
3. 强调 (Emphasis)
使用 *
或 _
包围文本实现斜体,使用 **
或 __
实现粗体。
*斜体文本*_斜体文本_**粗体文本**__粗体文本__***粗斜体文本***___粗斜体文本___
效果:
斜体文本 斜体文本
粗体文本 粗体文本
粗斜体文本 粗斜体文本
4. 列表 (Lists)
无序列表
使用 *
、+
或 -
表示。
- 项目一- 项目二- 子项目二点一- 子项目二点二* 项目三+ 项目四
有序列表
使用数字加点。
1. 第一项2. 第二项1. 子项二点一2. 子项二点二3. 第三项
效果:
-
项目一
-
项目二
-
子项目二点一
-
子项目二点二
-
-
项目三
-
项目四
-
第一项
-
第二项
-
子项二点一
-
子项二点二
-
-
第三项
5. 链接 (Links)
行内链接
这是一个[示例链接](https://www.example.com)。
参考式链接
这是一个[示例链接][1]。[1]: https://www.example.com
自动链接
<https://www.example.com>
效果:
这是一个示例链接。
6. 图片 (Images)
语法与链接类似,但前面加 !
。
行内图片

参考式图片
![替代文本][image1][image1]: https://www.example.com/image.jpg
指定图片大小(扩展语法,部分渲染器支持)

效果:
7. 代码 (Code)
行内代码
使用反引号 `
包围。
这是一个 `行内代码` 示例。
代码块
使用缩进四个空格或使用三个反引号 ``` 包围。
缩进方式
这是一个代码块。可以包含多行代码。
反引号方式
这是一个代码块。 可以包含多行代码。
语法高亮(支持的渲染器)
在三个反引号后指定语言。
```python def hello_world():print("Hello, world!")
效果:```python def hello_world():print("Hello, world!")
8. 引用 (Blockquotes)
使用 >
表示引用。
> 这是一个引用。 > 可以包含多行文本。> ### 嵌套引用 > 引用中可以包含标题。
效果:
这是一个引用。 可以包含多行文本。
嵌套引用
引用中可以包含标题。
9. 分割线 (Horizontal Rules)
使用三个或以上的 -
、*
或 _
。
---* * *___
效果:
10. 表格 (Tables)
使用 |
和 -
来创建表格。
| 表头1 | 表头2 | 表头3 | | ------ | ------ | ------ | | 单元格1 | 单元格2 | 单元格3 | | 单元格4 | 单元格5 | 单元格6 |
对齐方式
通过在分隔符中添加 :
来设置对齐方式。
-
左对齐:
:---
-
右对齐:
---:
-
居中对齐:
:---:
| 左对齐 | 右对齐 | 居中对齐 | | :------ | ------: | :------: | | 单元格1 | 单元格2 | 单元格3 | | 单元格4 | 单元格5 | 单元格6 |
效果:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格1 | 单元格2 | 单元格3 |
单元格4 | 单元格5 | 单元格6 |
11. 内联 HTML
Markdown 允许直接嵌入 HTML 代码,用于实现 Markdown 不支持的格式。
这是一个使用 <span style="color:red">红色文本</span> 的示例。
效果:
这是一个使用 红色文本 的示例。
12. 转义字符
使用反斜杠 \
转义 Markdown 特殊字符,使其作为普通字符显示。
\* 反斜杠加星号显示为星号 * \# 显示为 #
效果:
* 反斜杠加星号显示为星号 * # 显示为 #
13. 注脚 (Footnotes)
部分渲染器支持注脚语法。
这是一个带注脚的句子。[^1][^1]: 这是注脚内容。
效果:
这是一个带注脚的句子。1
[1] 这是注脚内容。
14. 任务列表 (Task Lists)
部分渲染器支持任务列表。
- [x] 完成任务一 - [ ] 未完成任务二 - [ ] 未完成任务三
效果:
- 完成任务一
- 未完成任务二
- 未完成任务三
15. 表情符号 (Emojis)
部分渲染器支持使用 :
包围的表情符号代码。
这是一个笑脸 :smile:。
效果:
这是一个笑脸 😊。
16. 脚注 (Footnotes)
部分 Markdown 渲染器支持脚注。
这是一个带脚注的例子。[^1][^1]: 这是脚注内容。
效果:
这是一个带脚注的例子。1
[1] 这是脚注内容。
17. 自动编号列表 (Automatic Numbered Lists)
Markdown 会自动为有序列表编号,无需手动调整。
1. 第一项 1. 第二项 1. 第三项
效果:
-
第一项
-
第二项
-
第三项
18. 嵌套列表 (Nested Lists)
无序列表和有序列表可以相互嵌套。
1. 第一项- 子项一- 子项二 2. 第二项1. 子项二点一2. 子项二点二
效果:
-
第一项
-
子项一
-
子项二
-
-
第二项
-
子项二点一
-
子项二点二
-
19. 代码高亮 (Code Highlighting)
在代码块指定语言后,可以实现语法高亮。支持的语言取决于渲染器。
```javascript function greet() {console.log("Hello, world!"); }
效果:```javascript function greet() {console.log("Hello, world!"); }
20. 组合使用
Markdown 支持多种语法组合使用,以实现复杂的格式效果。
## 标题与列表结合- **粗体项**- *斜体子项*- `代码子项`1. 有序列表项1. **嵌套粗体**2. _嵌套斜体_
效果:
标题与列表结合
-
粗体项
-
斜体子项
-
代码子项
-
-
有序列表项
-
嵌套粗体
-
嵌套斜体
-
21. 其他扩展语法
一些 Markdown 渲染器支持额外的扩展语法,如:
-
表格扩展:支持复杂表格布局。
-
数学公式:使用 LaTeX 语法书写数学公式,如
$E=mc^2$
。 -
脚注:更复杂的脚注管理。
-
自定义容器:如信息框、警告框等。
示例:数学公式
爱因斯坦的质能方程:$E=mc^2$
效果:
爱因斯坦的质能方程:(E=mc^2)