第一章 Markdown基础
一、引言
- 简介
- Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
英文名 开发者 用途 特点 文件后缀名 MarkDown Aaron Swartz、John Gruber 文档快速排版 易读、易写、轻量、简单、通用 .md;.markdown;.mdown
- 特性
- 其内容是纯文本,语法简洁可直接阅读。
- 适用于任何文本编辑器,通用性强。
- 令使用者专注于内容,不会影响书写思路。
- 备注
- 以下优先由 转义 开始介绍,大部分特定符号的正常显示都需要进行转义操作。
- 以下介绍中所展示的所有的显示效果则都是通过 引用 的样式作为容器进行展示的。
二、转义
- 书写格式
\
1 +待转义的符号
- 应用范围
- 需要进行正常显示的特定符号
- 语法样例
\\ \` \* \_ \{
\} \[ \] \( \)
\# \+ \- \. \!
- 显示效果
\ ` * _ {
} [ ] ( )
# + - . !
三、引用
- 书写格式
>
2 +空格
+被引用的内容
- 应用范围
- 摘录的一些长段文章、资料等,诸如论文,技术文档等。
- 一些想要分享的心路历程,相关的名人名言,诗词歌赋等。
- 使用其外观,作为对话评论或某些文本内容的容器所使用。
- 语法样例
> Markdown 是一种轻量级标记语言
>
>>> 它允许人们使用易读易写的纯文本格式编写文档
- 显示效果
Markdown 是一种轻量级标记语言
它允许人们使用易读易写的纯文本格式编写文档
四、字体
- 书写格式
- 高亮
==
+内容
+==
- 删除线
~~
+内容
+~~
- 斜体
*
+内容
+*
_
+内容
+_
- 加粗
**
+内容
+**
__
+内容
+__
- 斜体加粗
***
+内容
+***
___
+内容
+___
- 应用范围
- 中英文混合文本中的英文,字体可以采用斜体。
- 需要突出的相关词语或语句,字体可以采用高亮或加粗。
- 文档更新被删除的特性、语句被其他语句替代的情况,字体可以采用删除线。
- 语法样式
==高亮==
~~删除线~~
*斜体* _斜体_
**加粗** __加粗__
***斜体加粗*** ___斜体加粗___
- 显示效果
高亮
删除线
斜体 斜体
加粗 加粗
斜体加粗 斜体加粗
五、列表
- 书写格式
- 应用范围
- 小标题可以采用有序列表的形式进行书写。
- 重点信息与注释信息等可以采用无序列表的形式进行书写。
- 语法样式
* 第一条
* 第一条第一项
+ 第二条
+ 第二条第一项
- 第三条
- 第三条第一项
1. 第一条
* 第一条第一项
2. 第二条
+ 第二条第一项
3. 第三条
- 第三条第一项
- 显示效果
- 第一条
- 第一条第一项
- 第二条
- 第二条第一项
- 第三条
- 第三条第一项
- 第一条
- 第一条第一项
- 第二条
- 第二条第一项
- 第三条
- 第三条第一项
六、代码
- 书写格式
- 代码段
`
+内容
+`
``
+内容
+``
- 代码块
```
+代码所属语言
4 +换行
+内容
+换行
+```
````
+代码所属语言
4 +换行
+内容
+换行
+````
- 应用范围
- 编程语言相关的代码。
- 键盘快捷键符号的书写可以采用代码段样式。
- 语法样式
`代码段`
``代码段``
```
代码块
```
```markdown
代码块
```
- 显示效果
代码段
代码段
代码块
代码块
七、链接
- 书写格式
- 普通链接
<
+网址或邮箱
+>
- 文字链接
[
+内容
+]
+(
+链接地址
+)
- 高级链接
[
+内容
+]
+[
+变量
+]
+换行
+[
+变量
+]
+:
+链接地址
- 应用范围
- 需要引用外部网站的内容。
- 语法样式
<www.markdown.com>
<link@markdown.com>
[文字链接](www.markdown.com)
[高级链接][链接变量]
[链接变量]:www.markdown.com
- 显示效果
<www.markdown.com>
link@markdown.com
文字链接
高级链接
八、图片
- 书写格式
- 行内式
!
+[
+内容
5 +]
+(
+图片地址
6 +空格
+"
7 +可选标题
8 +"
7 +)
- 参考式
!
+[
+内容
5 +]
+[
+变量
+]
+换行
+[
+变量
+]
+:
+图片地址
6 +"
7 +可选标题
8 +"
7
- 应用范围
- 需要详细解读的文章相关图片。
- 对文章起到装饰性作用的相关图片。
- 语法样式
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-jpSp74Wo-1641820786870)(./images/markdown.png)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-CqBajKUk-1641820786871)(./images/markdown.png "可选标题")]
![Markdown][图片变量一]
![Markdown][图片变量二]
[图片变量一]:./images/markdown.png
[图片变量二]:./images/markdown.png "可选标题"
- 显示效果
九、表格
- 书写格式
|
+字段
+|
+换行
+|
+-
9 +|
+换行
+|
+内容
+|
- 应用范围
- 数学类的相关统计信息。
- 相关内容或文档的说明信息。
- 语法样式
|字段一|字段二|
|-|---|
|内容一|内容二|
| 字段一 | 字段二 | 字段三 |
|:--- |:---:| ---:|
| 内容一 | 内容二 | 内容三 |
- 显示效果
字段一 字段二 内容一 内容二
字段一 字段二 字段三 内容一 内容二 内容三
十、分割线
- 书写格式
***
或---
或___
- 应用范围
- 文章描述的不同段落或内容之间。
- 标题与正文之间、正文与脚注之间。
- 语法样式
***
---
___
- 显示效果
十一、标题
- 书写格式
#
10 +空格
+标题
- 应用范围
- 标明文章、作品等内容的简短语句。
- 对文段进行分类的总结性词语或语句。
- 语法样例
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
- 显示效果
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题