段落与换行#

1
This will be
2
inline.
3
This is second paragraph.

1
This will be not
2
inline.

标题#

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

1
This is an H1
2
=============
3

4
This is an H2
5
-------------

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
    > This is a blockquote
3
    > 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.

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

在代码块内，符号 (&) 和 尖括号 (< 和 >) 会自动转换为 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
```