段落和换行#

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 标签：<h1>、<h2>、<h3>、<h4>、<h5>、<h6>

在行首使用 1-6 个井号（#），分别对应 <h1> - <h6>。

代码：

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

预览：

This is an H6#

你也可以选择”闭合” atx 风格的标题。闭合的井号数量不需要与开头的井号数量一致。

代码：

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

预览：

This is an H3#

块引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 字符表示块引用。如果对文本进行硬换行并在每一行前加上 >，效果最佳。

代码：

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.

预览：

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 也允许你偷懒，只在硬换行段落的第一行前加上 >。

代码：

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.

预览：

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.

块引用可以嵌套（即块引用中的块引用），只需添加更多层级的 >。

代码：

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

预览：

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

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

代码：

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");

预览：

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 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

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

在代码块内，***and 符号（&）*和尖括号（< 和 >）**会自动转换为 HTML 实体。

代码：

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

预览：

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 /> 在单独一行中放置三个或更多连字符（-）、星号（*）或下划线（_）。连字符或星号之间可以有空格。

代码：

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

预览：

表格#

HTML 标签：<table>

这是一个扩展语法。

使用**竖线（|）分隔列，使用连字符（-）分隔表头，并使用冒号（:）**设置对齐方式。

外侧的**竖线（|）**和对齐设置是可选的。每个单元格至少需要 3 个分隔符来分隔表头。

代码：

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

预览：

链接#

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>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果 * 或 _ 两侧有空格，它就会被当作普通的星号或下划线字符。

你可以使用反斜杠转义：

代码：

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

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用**反引号（`）**包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

要在代码片段中包含字面反引号字符，可以使用多个反引号作为开始和结束分隔符：

代码：

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

预览：

There is a literal backtick (`) here.

包裹代码片段的反引号分隔符可以包含空格——开始后一个，结束前一个。这样就可以在代码片段的开头或结尾放置字面反引号字符：

代码：

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

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

预览：

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>

这是一个扩展语法。

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

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

自动链接#

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
\*literal asterisks\*

预览：

*literal asterisks*

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

代码：

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