下面是一份完整的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. 项目1
  2. 项目2
    1. 子项目1
    2. 子项目2
  3. 项目3

5. 链接

Markdown支持行内链接和引用式链接。

[行内链接](https://www.example.com)

[引用式链接][1]

[1]: https://www.example.com "可选标题"

效果:

行内链接

引用式链接

6. 图片

图片的语法与链接类似,前面加上 !

![alt文字](https://www.example.com/image.jpg "可选标题")

效果:

alt文字

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简单易学且易于阅读,使其成为编写文本和代码的理想选择。


  1. 注脚内容。