段落和换行#

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.  麦克海尔
3
3.  帕里什

1
1986. 多么伟大的赛季。

1
1986\. 多么伟大的赛季。

1
*   包含引用块的列表项:
2

3
    > 这是一个引用块
4
    > 在列表项内。

1
*   包含代码块的列表项:
2

3
        <code goes here>

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/) 没有标题属性。

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 使用旨在类似于链接语法的图片语法，允许两种样式：内联和引用。

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

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

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
!   感叹号