[置顶]MarkDown基本语法教程

Markdown 是一种轻量级的标记语言,它允许你使用易读易写的纯文本格式编写文档,然后转换成结构化的 HTML(超文本标记语言)文档。Markdown 由约翰·格鲁达(John Gruber)和亚伦·斯沃茨(Aaron Swartz)于 2004 年创建。本文将介绍基本的 Markdown 语法,帮助你快速上手。

一、标题

Markdown 使用井号(#)来表示标题,井号的数量决定了标题的层级。从 # 表示一级标题,到 #### 表示四级标题。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

二、段落

段落之间需要有一个或多个空白行来分隔。每个段落可以包含多行文本。

这是第一个段落。

这是第二个段落。

三、斜体和粗体

粗体:使用双星号(*)包裹文本。
斜体:使用单星号(
)包裹文本。
斜粗体:使用三个星号(*)包裹文本。

**粗体文本**
*斜体文本*
***斜粗体文本***

四、列表

无序列表
使用减号(-)、加号(+)或星号(*)来创建无序列表。每个列表项占一行。

- 列表项1
- 列表项2
  - 子列表项1
  - 子列表项2

有序列表
使用数字后跟一个点(.)来创建有序列表。每个列表项占一行。

1. 列表项1
2. 列表项2
    1. 子列表项1
    2. 子列表项2

五、链接

链接的语法是

[链接文本](目标URL)。
[谷歌](https://www.google.com)

谷歌

六、图片

图片的语法是

 图片 ![替代文本](图片URL)。
 ![GitHub Logo](https://github.com/favicon.ico)
 链接图片 [![替代文本](图片URL)](链接地址)
 [![GitHub Logo](https://github.com/favicon.ico)](www.github.com)

图片
GitHub Logo

链接图片
GitHub Logo

七、代码块

内联代码
使用反引号(`)包裹代码片段。

`console.log('Hello, World!');`

多行代码块
使用三个反引号(```)包裹多行代码,并可以在开头指定语言类型。

function helloWorld() {
    console.log('Hello, World!');    #这是一个测试代码
}

八、引用

使用大于号(>)来创建引用块。

> 这是一个引用块。
>
> 引用可以包含多个段落。

九、分割线

在一行中插入三个或更多破折号(—-)或星号(*)来创建分割线。

---

十、表格

表格的语法稍微复杂一些,但非常强大。使用 - 来创建分隔行,使用 | 来分隔单元格。

| 列1 | 列2 | 列3 |
|------|------|------|
| 行1列1 | 行1列2 | 行1列3 |
| 行2列1 | 行2列2 | 行2列3 |

十一、转义字符

如果需要在 Markdown 文档中显示特殊字符(如 *、_、{、}、\ 等),需要使用反斜杠(\)进行转义。

\*、\_、\{、\}、\\

结语

Markdown 的语法简洁明了,易于学习和使用。通过掌握上述基本语法,你可以轻松地编写出美观且结构清晰的文档。希望这篇教程对你有所帮助!