MarkDown语法
1 标题
用数个“#”加上空格表示标题行,一共六级:例如
Markdown语句
## 2 二级标题示例
### 3 三级标题示例
#### 4 ...
显示效果:
2 二级标题示例
3 三级标题示例
4 …
2 段落
使用空白行将文本的一行或多行分隔创建段落,不能缩进带有制表符和空格的段落,如:
这是第一个段落
这是第二个段落
显示效果:
这是第一个段落
这是第二个段落
3 换行
换行需要使用两个或者多个空格加上回车,如:
这是第一行
这是第二行,注意这是行不是段
显示效果:
这是第一行
这是第二行,注意这是行不是段
4 强调
强调可以使文本加粗或斜体表示
4.1 斜体
用一个星号或下划线表示斜体,如:
*这是用星号表示的斜体*
_这是用下划线表示的斜体_
显示效果:
这是用星号表示的斜体
这是用下划线表示的斜体
4.2 粗体
用两个星号或下划线表示粗体,如:
这是用星号表示的**粗体**
这是用下__划线__表示的粗体
显示效果:
这是用星号表示的粗体
这是用__下划线__表示的粗体
4.3 粗斜体
用三个星号或下划线表示粗斜体,如:
这是用星号表示的***粗斜体文字***
___这是用下划线表示的粗斜体文字___
显示效果:
这是用星号表示的粗斜体文字
这是用下划线表示的粗斜体文字
5 分隔线
在单独的一行用三个以上的星号、减号或下划线建立分隔线,如:
这是用星号表示的分隔线
***
这是用减号表示的分隔线
---
这是用下划线号表示的分隔线
___
显示效果:
这是用星号表示的分隔线
这是用减号表示的分隔线
这是用下划线号表示的分隔线
6 删除线
在文本前后各添加两个波浪线,显示出删除效果,如:
~~这是被删除的文本~~
这是一个~~拼过~~苹果
显示效果:
这是被删除的文本
这是一个拼过苹果
7 下划线
用HTML标签 实现下划线效果,如:
我是<u>中国</u>人
显示效果:
我是中国人
8 块引用
用>表示区块引用,可以增加>个数嵌套使用,如:
>区块一
>
>区块二
>>区块二第一
显示效果:
区块一
区块二
区块二第一
块引用可以包含其他Markdown格式的元素。
9 代码
9.1 片段代码
前后各一个(`)符号表示代码片段。如果要表示为代码的单词或短语包含一个或多个(`)符号,可以通过将单词或短语括在(````)中来对其进行转义,如:
C语言中使用`printf`函数
```void` is the keyword of C``
显示效果:
C语言中使用printf
函数
```void` is the keyword of C``
9.2 代码行
用4个空格或一个制表位创建代码块,如:
#include <stdio.h>
显示效果:
#include <stdio.h>
9.3 代码块
在代码块之前和之后的行上使用三个刻度线(```)或三个波浪号(~~~)括住,创建区域代码块。在代码块的第一行指定编程语言,可以高亮显示,如:
```c
#include <stdio.h>
int main(void)
{
return 0;
}
```
显示效果:
#include <stdio.h>
int main(void)
{
return 0;
}
10 列表
10.1 无序列表
在文本前添加星号、加号或减号并和至少一个空格的组合作为标记创建无序列表,缩进可以嵌套使用列表如:
* 第一项
* 第二项
* 第三项
- 第一章
+ 第二章
* 第三章
* 第一页
* 第一行
* 第二行
* 第二页
* 第三页
显示效果:
- 第一项
- 第二项
- 第三项
- 第一章
- 第二章
-
第三章
-
第一页
- 第一行
- 第二行
-
第二页
-
第三页
10.2 有序列表
用数字、点和空格的组合创建有序列表。数字不必按数字顺序排列,但列表应以数字开头,允许嵌套如:
1. 首先
3. 其次
今天是美好的一天。
2. 最后
1. 第一
2. 第二
3. 第三
1. 首先
2. 其次
显示效果:
-
首先
-
其次
今天是美好的一天。 -
最后
-
第一
-
第二
-
第三
- 首先
- 其次
10.3 列表和其余元素混合使用
要在保留列表连续性的同时在列表中添加另一个元素,将该元素缩进四个空格或一个制表符。
10.3.1 段落
- 这是第一个列表项。
- 这是第二个列表项。
我需要在第二个列表项下面添加另一段。
- 这是第三个列表项。
显示效果:
-
这是第一个列表项。
-
这是第二个列表项。
我需要在第二个列表项下面添加另一段。 -
这是第三个列表项。
10.3.2 区块
+ 这是第一个列表项。
+ 这是第二个列表项。
> 在第二个列表项的下方,blockquote看起来不错。
+ 这是第三个列表项。
显示效果:
-
这是第一个列表项。
-
这是第二个列表项。
在第二个列表项的下方,区块看起来不错。
-
这是第三个列表项。
10.3.3 代码
代码块通常缩进四个空格或一个制表符。当它们在列表中时,将它们缩进八个空格或两个制表符。
1. 打开文件源文件
2. 查找第15行的错误
void mian()
3. 并将其改正
显示效果:
-
打开文件源文件
-
查找第15行的错误
void mian()
-
并将其改正
11 链接
要创建链接,将链接文本括在方括号中,然后立即在后面加上园括号和URL ,如:
这是百度公司的[网址](www.baidu.com)
显示效果:
这是百度公司的网址
11.1 添加标题
可以选择为链接添加标题,用引号括在URL后面的括号中。当用户将鼠标悬停在链接上时,将显示为工具提示,如:
这是百度公司的[网址](www.baidu.com "我最常用的网站")
显示效果:
这是百度公司的网址
11.2 网址和邮箱
用(<>)将网站地址或邮箱地址快速转换为链接,如:
<www.baidu.com>
显示效果:
<www.baidu.com>
11.3 突显网址
可以用星号将整个链接括起来表达强调效果,如:
这是百度公司的**[网址](www.baidu.com "我最常用的网站")**
显示效果:
这是百度公司的**网址**
12 图片
添加感叹号(!
),然后在括号中添加替代文本,并在括号中添加图像资源的路径或URL。也可以选择在括号中的URL之后添加标题,如:
![这是故宫的实例图片](F:\故宫.jpeg "故宫全貌")
显示效果:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xrEZ44BW-1659281997796)(F:\故宫.jpeg “故宫全貌”)]
可以为图片添加链接,将图像的Markdown语句括在方括号中,然后在括号中添加链接,如:
[![这是故宫的实例图片](F:\百度.jpeg "访问百度")](www.baidu.com)
显示效果:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cppLiZZP-1659281997797)(F:\百度.jpeg “访问百度”)]
13 转义字符
要显示原义字符,在字符前面添加反斜杠(\),如:
\#
\`
\*
斜体\*文字\*
显示效果:
#
`
*
斜体文字
14 表格
要添加表,使用三个或多个连字符(---
)创建每列的标题,并使用管道(|
)分隔每列,可以在表的任一端添加管道,可以格式化(链接、代码和强调)表格中的文本。使用(-:)表示右对齐,(:-)表示左对齐,(:-:)中间对齐,如:
| 时间 | 人物 |
| :----------: | :----: |
| 2022年6月6日 | 张三 |
| 2022年6月7日 | 李四 |
显示效果:
时间 | 人物 |
---|---|
2022年6月6日 | 张三 |
2022年6月7日 | 李四 |
15 脚注
在方括号([^1]
)内添加插入符号和标识符。标识符可以是数字或文字,但不能包含空格或制表符。标识符仅将脚注参考与脚注本身相关联,脚注按顺序编号。
我是中国[^1]人,我爱我的祖国[^标识]。
[^1]: 中华人民共和国,简称“中国”,成立于1949年10月1日。
[^标识]: 根据《现代汉语词典》的解释,祖国就是自己的国家。
显示效果:
16 任务清单
任务列表可以创建带有复选框的项目列表。要创建任务列表,在任务列表项之前添加破折号(-
)和方括号,并在[ ]
前和内加上一个空格()。要选择一个复选框,在方括号([ ]
)内写上(x),如:
- [x] 第一项
- [ ] 第二项
显示效果:
- 第一项
- 第二项