Markdown 语法全面介绍

Markdown 是一种轻量级标记语言,创建于2004年,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。本文将全面介绍 Markdown 的基本语法和常用功能。 本博客也是采用markdown语法编写,所以本篇文章也作为语法查阅使用。

1. 标题

Markdown 支持六级标题,使用 # 符号表示:

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

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 段落与换行

在 Markdown 中,段落由一个或多个空行分隔。如果要在段落内换行,可以在行尾添加两个或更多空格,然后按回车键。

这是第一段。

这是第二段。

这是一行,  
这是强制换行后的内容。

3. 强调

Markdown 使用星号(*)和下划线(_)作为强调标记:

*斜体文本* 或 _斜体文本_
**粗体文本**__粗体文本__
***粗斜体文本*** 或 ___粗斜体文本___
~~删除线文本~~

效果: 斜体文本斜体文本 粗体文本粗体文本 粗斜体文本粗斜体文本 删除线文本

4. 列表

无序列表

无序列表可以使用星号(*)、加号(+)或减号(-)作为列表标记:

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

效果:

  • 第一项
  • 第二项
  • 第三项

有序列表

有序列表使用数字并加上 . 号来表示:

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

效果:

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

嵌套列表

列表嵌套只需在子列表中的选项前面添加四个空格即可:

1. 第一项:
    - 第一子项
    - 第二子项
2. 第二项:
    - 第一子项
    - 第二子项

5. 链接

Markdown 支持两种形式的链接语法:行内式和参考式。

行内式

[链接名称](链接地址)
[链接名称](链接地址 "链接标题")

示例: GitHub Google

参考式

这是 [参考式链接][id]
[id]: https://www.example.com "可选标题"

6. 图片

插入图片的语法和链接类似,只是前面多了一个感叹号:

![替代文本](图片链接)
![替代文本](图片链接 "可选标题")

7. 引用

在段落前使用 > 符号,表示引用:

> 这是一段引用内容
> 多行引用
>> 嵌套引用

效果:

这是一段引用内容 多行引用

嵌套引用

8. 代码

行内代码

使用反引号(`)包裹代码:

`print("Hello, World!")`

效果:print("Hello, World!")

代码块

使用三个反引号(```)或者四个空格缩进来创建代码块:

```python
def hello_world():
    print("Hello, World!")
    
hello_world()
```

或者:

    def hello_world():
        print("Hello, World!")
        
    hello_world()

9. 分隔线

可以在一行中使用三个或更多的星号、减号或下划线来创建分隔线:

***
---
___

效果都是一条水平线:


10. 表格

Markdown 表格语法如下:

| 表头1 | 表头2 | 表头3 |
| -----| ----- | ----- |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

效果:

表头1表头2表头3
单元格1单元格2单元格3
单元格4单元格5单元格6

通过在表头下方的分隔线中使用冒号(:),可以设置表格内容的对齐方式:

| 左对齐 | 居中对齐 | 右对齐 |
| :-----| :----: | -----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

11. 任务列表

Markdown 支持任务列表,使用 - [ ]- [x] 语法:

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务

效果:

  • 已完成任务
  • 未完成任务
  • 另一个未完成任务

12. 脚注

这里有一个脚注[^1]

[^1]: 这是脚注的内容

13. HTML 支持

Markdown 允许直接在文档中使用 HTML 标签:

<div style="color: red">
    这是一段红色文本
</div>

总结

Markdown 是一种简洁、高效的文本格式化语言,广泛应用于博客、文档编写、README文件和论坛帖子等场景。掌握这些基本语法,你就能够创建格式丰富、结构清晰的文档了。更多高级用法可以参考 Markdown 官方文档或其他扩展语法,如 GitHub Flavored Markdown。

以上内容已经包含了Markdown语法的全面介绍,并为每种语法都提供了相应的示例。您可以根据需要进一步修改或增加其他Markdown特性。