Markdown 语法指南
Markdown 语法指南
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)。由于其简洁的语法和良好的可读性,Markdown 已经成为博客、技术文档、笔记等领域广泛使用的格式。本指南将详细介绍Markdown的各种语法元素,帮助您快速掌握其使用方法。
标题
Markdown 使用 # 号来表示标题的级别,从一级标题到六级标题。
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
段落与换行
Markdown 中的段落由一个或多个连续的文本行组成,段落之间用一个或多个空行分隔。
如果您需要在段落内强制换行,可以在行尾使用两个或更多的空格,然后换行。
这是一个段落。
这是一个带有强制换行的段落。
强调
Markdown 提供了两种强调文本的方式:粗体和斜体。
- 粗体: 使用两个星号
**或两个下划线__包裹文本。 - 斜体: 使用一个星号
*或一个下划线_包裹文本。
这是**粗体**文本。
这是__粗体__文本。
这是*斜体*文本。
这是_斜体_文本。
您也可以组合使用,例如**粗斜体**。
列表
Markdown 支持两种类型的列表:无序列表和有序列表。
无序列表
无序列表使用星号 *、加号 + 或减号 - 作为列表项的标记,标记后面需要跟一个空格。
* 项目一
* 项目二
* 子项目一
* 子项目二
+ 项目三
- 项目四
有序列表
有序列表使用数字后跟一个英文句点 . 作为列表项的标记,数字的顺序并不重要,Markdown 会自动编号。
1. 第一项
2. 第二项
1. 子第一项
2. 子第二项
3. 第三项
链接
Markdown 支持两种类型的链接:行内链接和参考链接。
行内链接
行内链接的格式为 [链接文本](URL "可选的标题")。
这是一个[行内链接](https://www.example.com "访问Example.com")。
参考链接
参考链接更适合在文章中多次引用同一个链接,或者链接文本与实际URL不同时使用。
首先,在文本中定义链接引用:
[链接文本][引用名]
然后在文档的任何位置(通常是末尾)定义这个引用:
[引用名]: URL "可选的标题"
我正在学习[Markdown][md-syntax]。
[md-syntax]: https://www.markdownguide.org/ "Markdown 官方指南"
图片
图片的语法与链接类似,只是在前面多一个感叹号 !。
行内图片


参考图片
![替代文本][引用名]
[引用名]: 图片URL "可选的标题"
![风景图][landscape]
[landscape]: https://www.example.com/images/landscape.jpg "美丽的风景"
代码
Markdown 支持两种代码显示方式:行内代码和代码块。
行内代码
使用反引号 ` 包裹行内代码。
在文本中插入`console.log('Hello, Markdown!');`。
代码块
使用三个反引号 包裹多行代码,并且可以指定代码语言以实现语法高亮。
```javascript
function greet(name) {
console.log('Hello, ' + name + '!');
}
greet('World');
```
引用
Markdown 使用大于号 > 来表示引用块。
> 这是引用块的内容。
>
> 这是一个嵌套的引用块:
> > 这是一个更深层的引用。
分隔线
水平分隔线可以使用三个或更多个星号 *、减号 - 或下划线 _ 来创建,它们之间可以有空格。
***
---
___
表格
Markdown 支持使用管道符 | 和减号 - 来创建表格。
| 列标题一 | 列标题二 | 列标题三 |
| :------- | :------: | -------: |
| 内容一 | 内容二 | 内容三 |
| 内容四 | 内容五 | 内容六 |
:---表示左对齐:---:表示居中对齐---:表示右对齐
其他
删除线
使用两个波浪号 ~~ 包裹文本。
这是~~被删除的文本~~。
转义字符
如果你想显示Markdown语法本身,而不是让它被解析,可以使用反斜杠 \ 来转义。
\* 这不是一个列表项
\# 这不是一个标题
掌握Markdown语法将极大地提升您的写作效率和文档的可读性。希望本指南能帮助您更好地使用Markdown。