Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面或其他格式。遵循Markdown的格式规范,可以让你的文档更加清晰易读。以下是编写Markdown文档时的一些基本规范:
1. 文件保存格式
- 使用
.md作为文件扩展名。
2. 标题
- 标题分级:Markdown使用不同的符号表示不同的标题级别,从最高级别的
#到最低级别的#,最多使用6个#。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
3. 段落
- 默认情况下,Markdown会在两个空行之间自动生成段落。
4. 换行
- 在文本中按
Enter键会产生换行符,但Markdown会将连续的多个换行符视为一个段落。
5. 空行
- 两个空行表示一个新的段落。
6. 字体样式
- 粗体:在文字前后各加上两个
*符号。 - 斜体:在文字前后各加上一个
*符号。 - 删除线:在文字前后各加上两个
~符号。
**这是粗体文本**
*这是斜体文本*
~~这是删除线文本~~
7. 列表
- 无序列表:在文本前加上
-、*或+符号。 - 有序列表:在文本前加上数字和英文句点。
- 项目一
- 项目二
- 项目三
1. 项目一
2. 项目二
3. 项目三
8. 链接
- 使用方括号标记链接文本,圆括号标记URL。
[这是一个链接](https://www.example.com)
9. 图片
- 使用方括号标记图片描述,圆括号标记图片URL。

10. 代码块
- 使用三个”“符号包裹代码,可指定代码语言。
```python
def hello_world():
print("Hello, World!")
## 11. 表格
- 使用竖线`|`和短横线`-`分隔表头、行和列。
```markdown
| 表头1 | 表头2 | 表头3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
12. 引用
- 使用大于号
>标记引用。
> 这是一个引用示例。
13. 分隔线
- 使用三个或更多短横线、下划线或星号来创建分隔线。
---
---
___
***
总结
遵循Markdown格式规范,可以使你的文档更加清晰易读。通过熟练运用Markdown的语法,你可以在各种场景下轻松编写文档。希望这篇指南能帮助你更好地使用Markdown。
