段落与换行#

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.  鸟
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  "可选 title 属性"
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
!   感叹号