Markdown 语法详解
Markdown 是一种轻量级标记语言,可以通过使用特殊的标记符号格式化纯文本。以下是详细的 Markdown 语法说明及实例。
标题
Markdown 使用 #
号来表示标题。从一级到六级标题分别使用一个到六个 #
符号。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落
段落是通过一个或多个空行来分隔的。直接输入文字即可创建段落。
这是第一段文字。
这是第二段文字。
强调
斜体 和 粗体 可以使用星号 (*) 或下划线 (_),用两个星号或下划线包裹文本表示 粗体,用一个星号或下划线包裹文本表示 斜体。
*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
列表
无序列表
无序列表可以使用星号 (*)、加号 (+)、或减号 (-) 表示。缩进来表示子列表。
* 项目一
* 项目二
* 子项目
* 子项目
+ 项目一
+ 项目二
+ 子项目
+ 子项目
- 项目一
- 项目二
- 子项目
- 子项目
有序列表
有序列表使用数字后面跟上一个点号和空格来表示。
1. 第一项
2. 第二项
1. 子项一
2. 子项二
链接
链接使用方括号 [链接文本] 包围显示内容,后接圆括号 (URL)。可以在 URL 后用空格再加上引号引入标题。
[Google](https://www.google.com)
[Google](https://www.google.com "前往 Google")
图片
与链接类似,只是在前面加一个感叹号 !。图片文本是图片的替代文字。
![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=https%3A%2F%2Fwww.example.com%2Fimage.jpg&pos_id=img-U9ego5BN-1716966469706)
![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=https%3A%2F%2Fwww.example.com%2Fimage.jpg%20%22%E5%9B%BE%E7%89%87%E6%A0%87%E9%A2%98%22&pos_id=img-euIsAE6j-1716966469707)
引用
使用 > 符号来表示引用。可以嵌套引用,通过增加 > 来表示嵌套层次。
> 这是一级引用。
>
> > 这是嵌套的引用。
代码
代码块
使用三个反引号包围的代码块 (```) 来表示多行代码块。可在第一个反引号后面指定语言。
这是代码块
```python
def hello_world():
print("Hello, world!")
### 行内代码
使用反引号 (`) 表示行内代码。
```markdown
这是 `行内代码` 示例。
表格
使用管道符和破折号来创建表格。
| 表头一 | 表头二 |
| ------ | ------ |
| 单元格一 | 单元格二 |
| 单元格三 | 单元格四 |
对齐方式:
| 左对齐 | 右对齐 | 居中对齐 |
| :------ | ------: | :------: |
| 1 | 2 | 3 |
| 4 | 5 | 6 |
水平线
使用三个或更多的 -、*、或 _ 创建水平线。
---
***
___
任务列表
使用短横加方括号 [ ] 创建任务列表;使用 [x] 表示已完成任务。
- [x] 完成任务
- [ ] 待办任务
- [ ] 另一个待办任务
注释
在 Markdown 文件中,HTML 注释也有效,可以用于写未显示的备注。
<!-- 这是注释 -->
脚注
脚注让你可以添加注释说明:
这是一个带脚注的句子[^1].
[^1]: 这是脚注的内容。
表情符号
支持一些常见的表情符号,如:
I :heart: Markdown.
扩展功能
一些Markdown编辑器和实现支持额外功能,例如Strikethrough(删除线):
~~这是删除线~~
组合功能实例
# 组合功能示例
本示例展示了多种Markdown功能的组合。
## 列表和引用
1. 项目一
* 子项目
> 这是一个引用。
2. 项目二
* [链接到Google](https://www.google.com)
## 代码和表格
代码块:
```python
print("Hello, world!")
表格:
表头一 表头二 表头三
左对齐 居中对齐 右对齐
单元格一 单元格二 单元格三
图片和表情
示例图片
预览
I :heart: Markdown.
以上就是一个完整、详细的 Markdown 语法说明及示例。希望这能帮助你更好地使用 Markdown。