Markdown入门之基本语法

541 阅读3分钟

Markdown基本语法

标题

要创建标题,请在单词或短语前面添加井号 (#) 。井号的数量代表了标题的级别。

# 一级标题
## 二级标题
### 三级标题

段落

要创建段落,请使用空白行将一行或多行文本进行分隔。

一段文字

另一段文字

换行

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行 (<br>)。

一行  
另一行

粗体

在单词或短语中间部分加粗的话,请使用双星号。

**加粗**

斜体

请在单词或短语前后添加一个星号。

*倾斜*

粗体和斜体

要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号。

***加粗并倾斜***

块引用

要创建块引用,请在段落前添加一个 > 符号。

> 这是一段引用

多个段落的块引用

块引用可以包含多个段落。为段落之间的空白行各添加一个 > 符号。

> 这是一段引用
>
> 这是另一段引用

嵌套块引用

块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。

> 这是一段引用
>> 这是嵌套的另一段引用

列表

有序列表

要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。

1. 第一项
2. 第二项
3. 第三项
4. 第四项

无序列表

要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

- 第一项
- 第二项
- 第三项
	- 第一小项
	- 第二小项
- 第四项

代码

要将单词或短语表示为代码,请将其包裹在反引号 (``) 中。

`console.log("hello,markdown!")`

代码块

代码块的前后可以使用三个反引号(```)来标记围栏代码块。如需添加语法高亮,请在围栏代码块前的反引号旁指定所用的编程语言。

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

分隔线

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

一段文字
***
另一段文字

链接

要创建链接,请将链接文本括在方括号中,后面紧跟着括在圆括号中的 URL。

搜索请使用[Google](https://www.google.com)

网址和电子邮件地址

要将 URL 或电子邮件地址快速转换为链接,请将其括在尖括号中。

<https://www.google.com>
<fake@example.com>

图片

要添加图片,首先请添加感叹号(!),然后紧跟着是方括号,方括号中可添加替代文本(alt text,即图片显示失败后显示此文本),最后跟着圆括号,圆括号中添加图片资源的路径或 URL。

![掘金](https://lf3-cdn-tos.bytescm.com/obj/static/xitu_juejin_web/dcec27cc6ece0eb5bb217e62e6bec104.svg)

图片链接

要为图片添加链接,请先为图片的 Markdown 标记添加一个方括号,然后紧跟着一个圆括号,并在圆括号中添加链接地址。

[![掘金](https://lf3-cdn-tos.bytescm.com/obj/static/xitu_juejin_web/dcec27cc6ece0eb5bb217e62e6bec104.svg)](https://juejin.cn/)

转义字符

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 (\) 。

\* 如果没有开头的反斜杠字符的话,这一行将显示为无序列表。