Markdown基本语法

本文最后更新于：2021年12月4日 凌晨

标题

  • 要创建标题，请在单词或短语前面添加井号 (# ) 。#号的数量代表了标题的级别。
1
2
3
4
5
6
7
8
9
10
11
# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题
  • 可选语法：
    还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 – 号来标识二级标题。
1
2
3
4
5
一级标题
===

二级标题
---

段落

  • 要创建段落，请使用空白行将一行或多行文本进行分隔。
1
2
3
4
5
6
7
one
two

three


four

换行

  • 在一行的末尾添加两个或多个空格，然后按回车键（return），即可创建一个换行（line break） (
    )。
1
2
This is the first line.  <--此处有2个空格，即可实现换行
And this is the second line.

几乎每个 Markdown 应用程序都支持两个或多个空格进行换行 (称为 “结尾空格（trailing whitespace）”) 的方式，但这是有争议的，因为很难在编辑器中直接看到空格，并且很多人在每个句子后面都会有意或无意地添加两个空格。由于这个原因，你可能需要使用除结尾空格以外的其它方式来进行换行。幸运的是，几乎每个 Markdown 应用程序都支持另一种换行方式：HTML 的 <br> 标签来实现换行。

强调

1. 粗体

  • 要加粗文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）。如需加粗一个单词或短语的中间部分用以表示强调的话，请在要加粗部分的两侧各添加两个星号（asterisks）。
1
2
3
**粗体**
__粗体__
强调**中间部分**使用粗体

Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致。为兼容考虑，在单词或短语中间部分加粗的话，请使用星号（asterisks）。

1
**粗体**

2. 斜体

  • 要用斜体显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。
1
2
3
*斜体*
_斜体_
强调*中间部分*使用斜体

Markdown 的众多应用程序在如何处理单词中间的下划线上意见不一致。为了兼容起见，请用星号标注单词中间的斜体来表示着重。

1
*斜体*

3. 删除线

  • 要使用删除线显示文本，请在单词或短语前后各添加两个波浪号。
1
~~删除线~~

4. 粗体和斜体混合使用

  • 要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。
1
2
3
4
5
***粗斜体***
___粗斜体___
**_粗斜体**_
--*粗斜体__*
强调***中间部分***使用粗斜体

引用

  • 要创建引用，请在段落前添加一个 > 符号。
1
2
3
4
5
6
7
8
> 一级引用
> > 二级引用
> > > 三级引用
> > > > 四级引用
> > > > > 五级引用
> > > > > > 六级引用
> > > > > > > 七级引用
... #引用可以多层嵌套

1. 多个段落的块引用

1
2
3
4
> one
> 
> two
> three

2. 嵌套块引用

1
2
3
> 标题
> 
>> 内容

3. 带有其它元素的块引用

1
2
3
4
5
6
> #### title
> 
> - one
> - two
> 
> *斜体* xxx

列表

1. 有序列表

  • 要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。
1
2
3
4
5
6
7
8
9
10
11
12
13
1. one
2. two
3. three

4. one
5. two
6. three

7. one
8. two
    1. three
    2. four
9. five

2. 无序列表

  • 要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
1
2
3
4
5
6
7
8
9
10
11
12
- one
- two
-three

* one
* two
* three

+ one
+ two
+ three

图片

1
![图片文字描述](图片存放路径)

代码

  • 可以在代码的前后加上`，将代码包括起来。
1
2
3
`Your code`

``Use `code` in your Markdown file.``

代码块

  • 代码块（Code blocks） 通常采用一对```将代码块包括到内部。
1

分隔线

  • 要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容。
1
2
3
4
5
***

---

___

链接

  • 要创建链接，请将链接文本括在方括号（例如 [Duck Duck Go]）中，后面紧跟着括在圆括号中的 URL（例如 (https://duckduckgo.com) ）。
1
[显示文本](网站)
  • 为链接添加标题
    你可以选择为链接添加标题（即 title 属性）。当用户将鼠标悬停在链接上时，将显示一个提示。要添加标题，请将其放在 URL 后面。
1
标题 [链接文本](网站)
  • 网址和电子邮件地址
    1
    2
    3
    <https://wwww.baidu.com>

    <1639945679@qq.com>

图片

  • 要添加图片，首先请添加感叹号（!），然后紧跟着是方括号，方括号中可添加替代文本（alt text，即图片显示失败后显示此文本），最后跟着圆括号，圆括号中添加图片资源的路径或 URL。你可以选择在圆括号中的 URL 之后添加标题（即 title 属性）。
1
![图片名称](图片路径)

带链接的图片

  • 要为图片添加链接，请先为图片的 Markdown 标记添加一个方括号，然后紧跟着一个圆括号，并在圆括号中添加链接地址。
1
[![图片名称](图片路径)](网址)

表格

1
2
3
4
5
6
7
8
9
10
11
| Tables        | Are           | Cool  |
|:-------------:|:-------------:|:-----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz