Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成结构化的HTML格式。下面将详细介绍 Markdown 文档的格式规范。
1. 文件扩展名
Markdown 文档通常使用 .md 作为扩展名。这是因为 .md 扩展名在文件系统中已经与 Markdown 格式相关联,便于识别和处理。
2. 基本结构
Markdown 文档的基本结构包括标题、段落、列表、引用、代码、表格、链接和图片等元素。
2.1 标题
Markdown 使用 # 符号来创建标题。一个 # 表示一级标题,两个 ## 表示二级标题,以此类推,最多六级标题。
# 一级标题
## 二级标题
### 三级标题
2.2 段落
在 Markdown 中,连续的文本被视为一个段落。段落之间需要空一行来区分。
这是一个段落。
这是另一个段落。
2.3 换行
在文本中,连续两个或两个以上的空格或一个制表符后回车,可以表示换行。
这是一个段落。
这是另一个段落。
2.4 列表
Markdown 支持无序列表和有序列表。
无序列表
使用 -、* 或 + 符号开头表示无序列表。
- 列表项1
- 列表项2
- 列表项3
有序列表
使用数字加英文句点表示有序列表。
1. 列表项1
2. 列表项2
3. 列表项3
2.5 引用
使用 > 符号表示引用。多级引用可以通过嵌套多个 > 符号来实现。
> 这是引用文本。
>>> 这是多级引用文本。
2.6 代码
使用三个反引号 `` 包裹代码块。支持多种编程语言。
```python
print("Hello, world!")
console.log("Hello, world!");
### 2.7 表格
使用竖线分隔列,使用 `-` 符号作为分隔线。
```markdown
| 表头1 | 表头2 | 表头3 |
| ---- | ---- | ---- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
2.8 链接
使用 []() 表示链接。
[Markdown](https://markdown.com.cn/)
2.9 图片
使用  表示图片。

3. 其他
Markdown 支持多种扩展插件,如表格、任务列表等。部分 Markdown 编辑器还支持 LaTeX 公式、脚注等高级功能。
遵循以上规范,可以方便地创建和编辑 Markdown 文档。
