目录
- Markdown介绍
- Markdown标题语法
- Markdown段落语法
- Markdown换行语法
- Markdown强调语法
- Markdown引用语法
- Markdown列表语法
- Markdown代码语法
- Markdown分割线语法
- Markdown链接语法
- Markdown图片语法
- Markdown转义字符语法
Markdown介绍
Markdown是一种轻量级标记语言,通过简单的符号实现文本格式化。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。
Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。
Markdown标题语法
要创建标题,请在单词或短语前面添加井号# 。# 的数量代表了标题的级别。
|标题级别|Markdown语法|预览效果|
|:---:|:---:|:---:|
|一级标题|# Heading level 1|
Heading level 1
|
|二级标题|## Heading level 2|
Heading level 2
|
|三级标题|### Heading level 3|
Heading level 3
|
如果想在表格中展示一级,二级标题效果时推荐如下方式
<h1>Heading level 1</h1>
<h2>Heading level 1</h2>
重点注意❗❗
用一个空格在 # 和标题之间进行分隔。
|✅正确示范|❌错误示范|
|:---:|:---:|
| # 这是标题 |#这是标题|
Markdown段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔。
Markdown语法中直接使用两次回车即可实现,但是在表格中我个人实践无法使用这种方式实现分段落,所以用HTML语法中
<p>来实现
```html我真的很喜欢使用 Markdown。
我想从现在开始我会用它来格式化我所有的文档。
## 重点注意❗❗
不要用**空格**或**制表符**缩进段落。
---
- <h1 id="Markdown换行语法">Markdown换行语法</h1>
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。
>Markdown语法中在行末添加两个空格即可实现,但是个人认为HTML语法是可视化的更加容易查改,所以用HTML语法中`<br>`来实现
```html
<p>这是第一行。<br>
这是第二行。</p>
Markdown强调语法
通过将文本设置为粗体或斜体来强调其重要性。
粗体
要加粗文本,请在单词或短语的前后各添加两个星号**。
斜体
要用斜体显示文本,请在单词或短语前后添加一个星号*。
粗体和斜体
要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号,中间不要带空格。
|字体类型|Markdown语法|预览效果|
|:---:|:---:|:---:|
|粗体| **这是粗体** |这是粗体|
|斜体| *这是斜体* |这是斜体|
|粗体和斜体|***这是粗体和斜体***|这是粗体和斜体|
Markdown引用语法
单个段落引用
要创建块引用,请在段落前添加一个 符号。>
>这是一句引用
这是一句引用
多个段落的块引用
块引用可以包含多个段落。 为段落之间的空白行添加一个 符号。>
>这是第一句引用
>
>这是第二句引用
这是第一句引用
这是第二句引用
嵌套块引用
块引用可以嵌套。 在要嵌套的段落前添加一个 符号。>>
>这是一句引用
>
>>这是内嵌语句
这是一句引用
这是内嵌语句
Markdown列表语法
有序列表
要创建有序列表,在每个列表项前添加数字并跟一个英文句点(.),用一个空格分隔序号和内容。
1. 第一项
2. 第二项
第一项
第二项
无序列表
要创建无序列表,请在每个列表项前面添加破折号(-),
用一个空格分隔序号和内容
- 第一项
- 第二项
- 第一项
- 第二项
重点注意❗❗
用一个空格在数字和句点(1.)或破折号(-)在内容之间进行分隔。
|✅正确示范|❌错误示范|
|:---:|:---:|
| 1. 第一项 |1.第一项|
| - 第一项 |-第一项|
Markdown代码语法
这里给出个人认为最简洁的方式围栏式代码块
要添加语法突出显示,请在代码块之前的反引号旁边指定一种语言。```c #include<stdio.h> int main(){ printf("Hello World"); } ```呈现的效果如下:
#include<stdio.h> int main(){ printf("Hello World"); }重点注意❗❗
三个反引号(```)不可以嵌套使用,如果想要嵌套需要三个波浪号(~~~)和三个反引号结合使用,否则会识别错误。
Markdown分割线语法
要创建分隔线,在单独一行上使用三个或多个星号 (*)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。
重点注意❗❗
请在分隔线的前后均添加空白行。
✅正确示范
尝试在之前插入一个空行
---
然后是水平分割线。
❌错误示范
没有空行,这将成为一个标题。
---
不要这样做!
Markdown链接语法
超链接Markdown语法代码:
这是一个链接 [Markdown语法](https://markdown.com.cn)。
呈现的效果如下:
这是一个链接 Markdown语法。
给链接增加 Title
链接title是当鼠标悬停在链接上时会出现的文字。
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。呈现的效果如下:
这是一个链接 Markdown语法。
另一种更简洁方式
使用尖括号
<>可以很方便地把URL或者email地址变成可点击的链接。<https://markdown.com.cn>呈现的效果如下:
https://markdown.com.cn
Markdown图片语法
插入图片Markdown语法代码:。
注意用一个
空格在图片链接和图片注释之间进行分隔,否则会报错。呈现的效果如下:
Markdown转义字符语法
要显示原本用于Markdown 文档的字符,在字符前面添加反斜杠字符\。
呈现的效果如下:\- 如果没有反斜杠,这将是无序列表中的项目符号。
- 如果没有反斜杠,这将是无序列表中的项目符号。
重点注意❗❗
反斜杠和要显示原本用于Markdown 文档的字符之间不能添加空格。