段落和换行#

1
这段文字将会
2
在同一行。
3

4
这是第二个段落。

1
这段文字将不会
2
在同一行。

标题#

Markdown 支持两种风格的标题：Setext 和 atx。

1
这是一个 H1
2
=============
3
这是一个 H2
4
-------------

atx#

HTML 标签：<h1>, <h2>, <h3>, <h4>, <h5>, <h6>

在行首使用 1-6 个井号 (#)，对应 <h1> - <h6>。

代码：

1
# 这是一个 H1
2
## 这是一个 H2
3
###### 这是一个 H6

预览：

这是一个 H6#

（可选）你可以“闭合” atx 风格的标题。闭合的井号数量不需要匹配用于开启标题的井号数量。

代码：

1
# 这是一个 H1 #
2
## 这是一个 H2 ##
3
### 这是一个 H3 ######

预览：

这是一个 H3#

引用块#

HTML 标签：<blockquote>

Markdown 使用类似电子邮件的 > 字符来进行块引用。如果你对文本进行硬换行，并在每一行前面放一个 >，效果看起来最好。

代码：

1
> 这是一个包含两个段落的引用块。Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

这是一个包含两个段落的引用块。Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许你偷懒，只在硬换行段落的第一行前面放 >。

代码：

1
> 这是一个包含两个段落的引用块。Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

这是一个包含两个段落的引用块。Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用块可以嵌套（即引用块中包含引用块），只需添加额外级别的 >。

代码：

1
> 这是引用的第一层级。
2
>
3
> > 这是嵌套的引用块。
4
>
5
> 回到第一层级。

预览：

这是引用的第一层级。

这是嵌套的引用块。

回到第一层级。

引用块可以包含其他 Markdown 元素，包括标题、列表和代码块。

代码：

1
> ## 这是一个标题。
2
>
3
> 1.   这是第一个列表项。
4
> 2.   这是第二个列表项。
5
>
6
> 这里有一些示例代码：
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

这是一个标题。#

1. 这是第一个列表项。
2. 这是第二个列表项。

这里有一些示例代码：

1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（编号）和无序（项目符号）列表。

1
*   红色
2
*   绿色
3
*   蓝色

1
+   红色
2
+   绿色
3
+   蓝色

1
-   红色
2
-   绿色
3
-   蓝色

1
1.  Bird
2
2.  McHale
3
3.  Parish

1
1986. 这是一个伟大的赛季。

1
1986\. 这是一个伟大的赛季。

1
*   带有引用块的列表项：
2

3
    > 这是一个在列表项
4
    > 里面的引用块。

1
*   带有代码块的列表项：
2

3
        <代码写在这里>

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

代码块#

HTML 标签：<pre>

将代码块的每一行至少缩进 4 个空格或 1 个制表符。

代码：

1
这是一个普通段落：
2

3
    这是一个代码块。

预览：

这是一个普通段落：

1
这是一个代码块。

一个代码块会一直持续，直到遇到没有缩进的行（或文章结尾）。

在代码块内，和号 (&) 和尖括号 (< 和 >) 会自动转换为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

以下部分的“围栏代码块”和“语法高亮”是扩展功能，你可以使用其他方式来编写代码块。

1
这里是一个示例：
2

3
```
4
function test() {
5
  console.log("注意到这个函数前面的空行了吗？");
6
}
7
```

1
function test() {
2
  console.log("注意到这个函数前面的空行了吗？");
3
}

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

水平分割线#

HTML 标签：<hr /> 在单独的一行上放置三个或更多的连字符 (-)、星号 (*) 或下划线 (_)。你可以在连字符或星号之间使用空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是一个扩展功能。

使用竖线 (|) 分隔列，使用破折号 (-) 分隔表头，并使用冒号 (:) 进行对齐。

最外层的竖线 (|) 和对齐方式是可选的。每个单元格至少有 3 个分隔符用于分隔表头。

代码：

1
| 左对齐 | 居中对齐 | 右对齐 |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

链接#

HTML 标签：<a>

Markdown 支持两种样式的链接：内联和引用。

1
这是一个[内联链接示例](http://example.com/ "标题")。
2

3
[这个链接](http://example.net/)没有 title 属性。

1
详情请参阅我的[关于](/about/)页面。

1
[id]: http://example.com/  "这里是可选的标题"
2
这是一个[引用样式链接示例][id]。

1
[foo]: http://example.com/  "这里是可选的标题"
2
[foo]: http://example.com/  '这里是可选的标题'
3
[foo]: http://example.com/  (这里是可选的标题)
4
[foo]: <http://example.com/>  "这里是可选的标题"

1
[Google]: http://google.com/
2
[Google][]

强调#

HTML 标签：<em>, <strong>

Markdown 将星号 (*) 和下划线 (_) 视为强调的指示符。单个分隔符将变成 <em>；双分隔符将变成 <strong>。

代码：

1
*单星号*
2

3
_单下划线_
4

5
**双星号**
6

7
__双下划线__

预览：

单星号

单下划线

双星号

双下划线

但是如果你用空格包围 * 或 _，它将被视为字面意义上的星号或下划线。

你可以使用反斜杠对其进行转义：

代码：

1
\*这段文字被字面意义上的星号包围\*

预览：

*这段文字被字面意义上的星号包围*

代码#

HTML 标签：<code>

使用反引号 (`) 将其包裹。

代码：

1
使用 `printf()` 函数。

预览：

使用 printf() 函数。

要在代码段中包含字面意义的反引号字符，你可以使用多个反引号作为开启和关闭的分隔符：

代码：

1
``这里有一个字面意义上的反引号 (`)。``

预览：

这里有一个字面意义上的反引号 (`)。

围绕代码段的反引号分隔符可以包含空格 —— 开启后一个，关闭前一个。这允许你在代码段的开头或结尾放置字面意义的反引号字符：

代码：

1
代码段中的单反引号：`` ` ``
2

3
代码段中用反引号分隔的字符串：`` `foo` ``

预览：

代码段中的单反引号：`

代码段中用反引号分隔的字符串：`foo`

图片#

HTML 标签：<img />

Markdown 使用类似于链接语法的图片语法，允许两种样式：内联和引用。

内联#

内联图片语法如下：![替代文本](URL "标题")

标题是可选的。

代码：

1
![替代文本](/path/to/img.jpg)
2

3
![替代文本](/path/to/img.jpg "可选标题")

预览：

---

---

即：

• 一个感叹号：!；
• 后跟一组方括号，包含图片的 alt 属性文本；
• 后跟一组括号，包含图片的 URL 或路径，以及一个可选的 title 属性，用双引号或单引号括起来。

引用#

引用样式图片语法如下：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "可选标题属性"
2
![替代文本][img id]

预览：

---

---

删除线#

HTML 标签：<del>

这是一个扩展功能。

GFM 添加了对文本添加删除线的语法。

代码：

1
~~错误的文本。~~

预览：

错误的文本。

自动链接#

Markdown 支持一种创建 URL 和电子邮件地址的“自动”链接的快捷方式：只需用尖括号将 URL 或电子邮件地址括起来。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动链接标准 URL。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许你使用反斜杠转义来生成字面字符，这些字符在 Markdown 的格式语法中原本具有特殊含义。

代码：

1
\*字面意义上的星号\*

预览：

*字面意义上的星号*

Markdown 为以下字符提供了反斜杠转义：

代码：

1
\   反斜杠
2
`   反引号
3
*   星号
4
_   下划线
5
{}  花括号
6
[]  方括号
7
()  圆括号
8
#   井号
9
+   加号
10
-   减号 (连字符)
11
.   英文句点
12
!   感叹号