@xkk 2022-12-25T14:50:25.000000Z 字数 2535 阅读 67

Markdown基本语法

Markdown 标题语法

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

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

Markdown 段落语法

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

我真的很喜欢使用Markdown。
我想从现在起我会用它来格式化我的所有文档。

我真的很喜欢使用Markdown。

我想从现在起我会用它来格式化我的所有文档。

Markdown 换行语法

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

这是第一行。  
这是第二行。

这是第一行。
这是第二行。

也可以使用HTML的<br> 标签来实现换行。

这是第一行。<br>
这是第二行。

这是第一行。
这是第二行。

Markdown 强调语法

粗体（Bold）

要加粗文本，请在要加粗文本的前后各添加两个星号**。

我只是喜欢**粗体**文本。

我只是喜欢粗体文本。

斜体（Italic）

要用斜体显示文本，请在单词或短语前后添加一个星号*。

粗体（Bold）和斜体（Italic）

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

这篇文章***非常重要***。

这篇文章非常重要。

Markdown 引用语法

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

> 为中华之崛起而读书

为中华之崛起而读书

Markdown 列表语法

有序列表

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

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

第一项
第二项
第三项

无序列表

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

- 第一项
- 第二项
- 第三项

第一项
第二项
第三项

Markdown 代码语法

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

在命令提示下，键入 `vim`

在命令提示下，键入 vim

转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。

``在你的 Markdown 中使用 `代码` ``

在你的 Markdown 中使用 `代码`

代码块

要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。

    <html>
      <head>
      </head>
    </html>

<html>
  <head>
  </head>
</html>

创建不用缩进的代码块，用围栏式代码块（fenced code blocks）.

``` html

\
\
\
\

```

<html>
    <head>
    </head>
</html>

Markdown 分隔线语法

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

为了兼容性，请在分隔线的前后均添加空白行。

---

***

___

Markdown 链接语法

超链接Markdown语法代码：[超链接显示名](超链接地址)

这是一个链接 [Markdown语法](https://markdown.com.cn)。

这是一个链接 Markdown语法。

给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔：[超链接显示名](超链接地址 "超链接title")

这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。

这是一个链接 Markdown语法。

网址和Email地址

<https://markdown.com.cn>
<fake@example.com>

https://markdown.com.cn

引用类型链接

[hobbit-hole][1]  
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle

hobbit-hole

Markdown 图片语法

插入图片Markdown语法代码：![图片alt](图片链接 "图片title")，图片title可省略。

![沙漠中的岩石图片](https://markdown.com.cn/assets/img/shiprock.c3b9a023.jpg "Shiprock")

沙漠中的岩石图片

Markdown 转义字符语法

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

\- 如果没有反斜杠，这将是无序列表中的项目符号。

- 如果没有反斜杠，这将是无序列表中的项目符号。

可做转义的字符

以下列出的字符都可以通过使用反斜杠字符从而达到转义目的。

Character	Name
\	backslash
`	backtick (see also escaping backticks in code)
*	asterisk
_	underscore
{ }	curly braces
[ ]	brackets
( )	parentheses
#	pound sign
+	plus sign
-	minus sign (hyphen)
.	dot
!	exclamation mark
\|	pipe (see also escaping pipe in tables)

特殊字符自动转义

在 HTML 文件中，有两个字符需要特殊处理： < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要使用这些符号，你必须要使用实体的形式，像是 < 和 &。

Markdown 允许你直接使用这些符号，它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分，那么它不会被转换，而在其它情况下，它则会被转换成 &。

Markdown 内嵌 HTML 标签

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到 Markdown 文本中即可。

出于安全原因，并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问，请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。