下面是一份完整的Markdown语法文档,涵盖了Markdown的基本和高级用法。
Markdown 语法指南
Markdown是一种轻量级的标记语言,旨在使书写文档更加简单和可读。以下是Markdown的主要语法规则。
1. 标题
Markdown支持六级标题,使用 #
符号表示。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
- 段落之间需要空一行。
- 在行末添加两个空格或者使用
<br>
标签可以实现换行。
这是第一段。
这是第二段。
这一行后面有两个空格,所以换行。<br>
这里使用了`<br>`标签来换行。
效果:
这是第一段。
这是第二段。
这一行后面有两个空格,所以换行。
这里使用了 <br>
标签来换行。
3. 强调
你可以使用星号或下划线来表示强调(斜体或粗体)。
*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
效果:
斜体 或 斜体
粗体 或 粗体
粗斜体 或 粗斜体
4. 列表
4.1 无序列表
使用 -
、*
或 +
表示无序列表。
- 项目1
- 项目2
- 子项目1
- 子项目2
* 项目3
效果:
- 项目1
- 项目2
- 子项目1
- 子项目2
- 项目3
4.2 有序列表
使用数字加上 .
表示有序列表。
1. 项目1
2. 项目2
1. 子项目1
2. 子项目2
3. 项目3
效果:
- 项目1
- 项目2
- 子项目1
- 子项目2
- 项目3
5. 链接
Markdown支持行内链接和引用式链接。
[行内链接](https://www.example.com)
[引用式链接][1]
[1]: https://www.example.com "可选标题"
效果:
6. 图片
图片的语法与链接类似,前面加上 !
。
![alt文字](https://www.example.com/image.jpg "可选标题")
效果:
7. 引用
使用 >
表示引用。
> 这是一个引用段落。
>
> 这还是引用的内容。
效果:
这是一个引用段落。
这还是引用的内容。
8. 代码
8.1 行内代码
使用反引号 `
包裹行内代码。
这是`行内代码`示例。
效果:
这是 行内代码
示例。
8.2 代码块
使用三个反引号
或者缩进四个空格来表示代码块。
```
这是一个代码块。
```
效果:
这是一个代码块。
如果需要语法高亮,可以在反引号后指定语言。
```python
def hello():
print("Hello, world!")
```
效果:
def hello():
print("Hello, world!")
9. 分割线
使用三个或三个以上的 -
、*
或 _
来创建分割线。
---
***
___
效果:
10. 表格
使用 |
分隔列,使用 -
分隔表头和内容。
| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
效果:
表头1 | 表头2 | 表头3 |
---|---|---|
内容1 | 内容2 | 内容3 |
内容4 | 内容5 | 内容6 |
11. 转义字符
Markdown中一些符号有特殊含义,如果你想显示这些符号而不是它们的语法含义,可以使用反斜杠 \
进行转义。
\*这不是斜体\*
\# 这不是标题
效果:
*这不是斜体*
# 这不是标题
12. 注脚
Markdown支持注脚,可以使用 [^1]
来创建。
这是一个注脚的示例[^1]。
[^1]: 注脚内容。
效果:
这是一个注脚的示例1。
13. 任务列表
可以创建任务列表,在复选框前使用 - [ ]
表示未完成,使用 - [x]
表示已完成。
- [ ] 任务1
- [x] 任务2
效果:
- 任务1
- 任务2
14. 文字删除线
使用 ~~
包裹要删除的文字。
~~这是一段删除线~~
效果:
这是一段删除线
15. HTML 语法
Markdown支持嵌入HTML标签,适用于一些Markdown不支持的格式。
<p style="color:red;">这是一个红色段落。</p>
效果:
这是一个红色段落。
这就是Markdown的基本语法,适用于编写各种文档、博客、README文件等。Markdown简单易学且易于阅读,使其成为编写文本和代码的理想选择。
注脚内容。 ↩