段落和换行符#

1
This will be
2
inline.
3

4
This is second paragraph.

1
This will be not
2
inline.

标题#

Markdown支持两种样式的标题，Setext和atx。

1
This is an H1
2
=============
3
This is an H2
4
-------------

atx#

HTML Tags: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>

在行首使用 1–6 个井号（#），分别对应 <h1> 至 <h6> 六级标题。 Code:

1
# This is an H1
2
## This is an H2
3
###### This is an H6

Preview:

This is an H6#

你也可以选择闭合 atx 风格的标题。结尾的#号数量不必与开头的#号数量一致。

Code:

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

Preview:

This is an H3#

引用块#

HTML 标签: <blockquote>

Markdown 使用电子邮件风格的 > 符号来表示引用块。如果手动换行并在每一行前都加上 >，显示效果会更美观。

Code:

1
> This is a blockquote with two paragraphs. 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.

Preview:

This is a blockquote with two paragraphs. 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 允许你偷懒，只在手动换行段落的第一行前面加上 > 即可。

Code:

1
> This is a blockquote with two paragraphs. 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.

Preview:

This is a blockquote with two paragraphs. 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.

引用块可以嵌套（即在引用块内再嵌套一层引用），只需增加对应的 > 层级即可。

Code:

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

Preview:

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

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

Code:

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

Preview:

This is a header.#

1. This is the first list item.
2. This is the second list item.

Here’s some example code:

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

列表#

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

1
*   Red
2
*   Green
3
*   Blue

1
+   Red
2
+   Green
3
+   Blue

1
-   Red
2
-   Green
3
-   Blue

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

1
1986. What a great season.

1
1986\. What a great season.

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

1
*   A list item with a code block:
2

3
        <code goes here>

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

代码块#

HTML 标签: <pre>

块的每一行缩进至少 4个空格 或 1个制表符（Tab） 。 Code:

1
This is a normal paragraph:
2

3
    This is a code block.

Preview:

This is a normal paragraph:

1
This is a code block.

代码块会一直持续到遇到非缩进行（或文章末尾）为止。 在代码块内部，& 符号（&）和尖括号（<和>） 会被自动转换为 HTML 实体字符。

Code:

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

Preview:

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

下面的围栏代码块和语法高亮属于扩展语法，你也可以用这种方式来编写代码块。

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

1
function test() {
2
  console.log("notice the blank line before this function?");
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 /> 在一行中单独放置三个或更多的短横线（-）、星号（*）或下划线（_）。符号之间可以添加空格。

Code:

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

Preview:

表格#

HTML 标签: <table>

这属于扩展语法。 使用 ** 竖线（|）分隔列，用短横线（-）分隔表头，并通过冒号（:）** 设置对齐方式。 两侧的竖线（|）和对齐设置均为可选。每个单元格至少需要3 个分隔符来区分表头。 Code:

1
| Left | Center | Right |
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

Preview:

链接#

HTML 标签: <a>

Markdown 支持两种链接样式：行内式和参考式。

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

1
See my [About](/about/) page for details.

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

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

强调#

HTML 标签: <em>, <strong>

Markdown 使用星号（*）和下划线（_）表示强调。 使用单个符号会被解析为 <em>。成对符号会被解析为 <strong>。

Code:

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

Preview:

single asterisks

single underscores

double asterisks

double underscores

但如果 (*) 或 (_) 两边都有空格，就会被当作普通星号或下划线处理。 你也可以用反斜杠转义：

Code:

1
\*this text is surrounded by literal asterisks\*

Preview:

*this text is surrounded by literal asterisks*

代码#

HTML 标签: <code>

用 ** 反引号（`）** 将其包裹起来即可。

Code:

1
Use the `printf()` function.

Preview:

Use the printf() function.

如果想在代码行内插入反引号本身，可以用多个反引号作为首尾分隔符：

Code:

1
``There is a literal backtick (`) here.``

Preview:

There is a literal backtick (`) here.

包裹行内代码的反引号分隔符前后可以加空格 —— 开头一个、结尾一个。这样就能在代码行内的开头或结尾直接使用反引号了。 Code:

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

Preview:

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签: <img />

Markdown 的图片语法借鉴了链接语法，支持两种样式：行内式和参考式。

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

删除线#

HTML 标签: <del>

这属于扩展语法。 GitHub Flavored Markdown（GFM）添加了删除线语法。

Code:

1
~~Mistaken text.~~

Preview:

Mistaken text.

自动链接#

Markdown 支持一种快捷方式来为 URL 和邮箱地址创建 “自动链接”：只需将 URL 或邮箱地址用尖括号包裹即可。

Code:

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

3
<address@example.com>

Preview:

http://example.com/

address@example.com

GFM 会自动为标准 URL 生成链接。

Code:

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

Preview:

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许你使用反斜杠转义，来输出那些在语法里原本有特殊含义的字符本身。

Code:

1
\*literal asterisks\*

Preview:

*literal asterisks*

Markdown 支持对以下字符使用反斜杠进行转义:

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark