[置顶] 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)
图片
七、代码块
内联代码
使用反引号(`)包裹代码片段。
`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 的语法简洁明了,易于学习和使用。通过掌握上述基本语法,你可以轻松地编写出美观且结构清晰的文档。希望这篇教程对你有所帮助!