编写Markdown文档时,遵循一定的格式规范可以让文档结构清晰,易于阅读和理解。以下是一些关键点,帮助你打造高质量的Markdown文档。
文档结构
1. 标题
Markdown使用不同数量的#号来表示标题的层级,从#到#6,分别对应1级到6级标题。例如:
# 一级标题
## 二级标题
### 三级标题
2. 段落
段落之间应该有一个空行来区分。直接输入文本,Markdown会自动将其识别为段落。
3. 换行
在行尾添加两个空格可以起到换行的作用。这对于长句或需要换行的内容非常有用。
4. 段落间距
段落间距可以通过添加一个或多个空行来控制,使文档结构更加清晰。
内容格式
1. 强调
使用星号(*)或下划线(_)来表示斜体或粗体:
*斜体*
**粗体**
2. 列表
- 无序列表:使用短横线(-)、星号(*)或加号(+)开头。
- 列表项1
- 列表项2
- 有序列表:使用数字和英文句点(。)开头。
1. 列表项1
2. 列表项2
3. 链接
使用方括号和圆括号来创建链接:
[链接文本](链接地址)
4. 图片
使用感叹号、方括号和圆括号来插入图片:

5. 代码
- 行内代码:使用反引号(`)包裹代码内容。
`代码内容`
- 代码块:使用三个反引号(“`)包裹代码,并指定代码语言(可选)。
```python
print("Hello, world!")
6. 表格
使用竖线(|)和短横线(-)创建表格:
| 表头1 | 表头2 | 表头3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
7. 分隔线
使用三个或更多短横线(-)、星号(*)或下划线(_)来创建分隔线:
---
8. 预格式化
使用反引号(`)包裹内容,可以使文本保留空格和换行:
`这是一个预格式化的段落。`
9. 引用
使用大于号(>)来表示引用:
> 这是一个引用的段落。
10. 表情符号
使用冒号和表情符号来表示表情符号:
:smile:
11. 代码高亮
使用三个反引号(”`)包裹代码,并指定代码语言:
```javascript
console.log("Hello, world!");
12. 高亮显示文本
使用两个波浪线(~~)包裹内容:
~~高亮文本~~
13. 任务列表
使用方括号和勾选符号来创建任务列表:
- [ ] 待完成事项1
- [x] 已完成事项2
14. 脚注
使用方括号和圆括号来创建脚注:
[1]: 脚注内容
遵循以上Markdown文档格式规范,可以帮助你编写清晰易读的Markdown文档,方便他人阅读和理解。
