Sign in Subscribe

Markdown基本语法

Last updated on 
Markdown基本语法

约翰·格鲁伯设计文档中概述的Markdown元素。

总览

几乎所有Markdown应用程序都支持John Gruber原始设计文档中概述的基本语法。Markdown处理器之间存在细微的差异和差异-尽可能在线内注明。

**注意：**使用Markdown并不意味着您也不能使用HTML。您可以将HTML标签添加到任何Markdown文件中。如果您更喜欢某些HTML标记而不是Markdown语法，这将很有帮助。例如，有些人发现将HTML标签用于图像更容易。

标题

要创建标题，请#在单词或短语的前面添加数字符号（）。您使用的数字符号的数量应与标题级别相对应。例如，要创建标题级别三（<h3>），请使用三个数字符号（例如### My Header）。

Markdown HTML 渲染输出
# Heading level 1

Heading level 1

 标题等级1
## Heading level 2

Heading level 2

 标题等级2
### Heading level 3

Heading level 3

 标题级别3
#### Heading level 4

Heading level 4

 标题级别4
##### Heading level 5
Heading level 5
 标题5
###### Heading level 6
Heading level 6
 标题等级6

替代语法

或者，在文本下方的行上，添加任意数量的==标题级别1的--字符或标题级别2的字符。

Markdown HTML 渲染输出
Heading level 1===============

Heading level 1

 标题等级1
Heading level 2---------------

Heading level 2

 标题等级2

段落

要创建段落，请使用空白行分隔一行或多行文本。您不应缩进带有空格或制表符的段落。

Markdown HTML 渲染输出
I really like using Markdown. I think I'll use it to format all of my documents from now on.

I really like using Markdown.

I think I'll use it to format all of my documents from now on.

 我真的很喜欢使用Markdown。 我想从现在开始，我将使用它来格式化所有文档。

换行

要创建换行符（<br>），请以两个或多个空格结束一行，然后键入return。

Markdown HTML 渲染输出
This is the first line. And this is the second line.

This is the first line.
And this is the second line.

 这是第一行。 这是第二行。

着重

您可以通过使文本变为粗体或斜体来增加着重。

粗体

要加粗文本，请在单词或短语的前后添加两个星号或下划线。要加粗一个单词的中部以强调，请在字母周围添加两个星号，且各空格之间不加空格。

Markdown HTML 渲染输出
I just love **bold text**. I just love bold text. 我只喜欢粗体字。
I just love __bold text__. I just love bold text. 我只喜欢粗体字。
Love**is**bold Loveisbold 爱是大胆的

斜体

要斜体显示文本，请在单词或短语的前后添加一个星号或下划线。要斜体突出单词的中间部分，请在字母周围添加一个星号，中间不要带空格。

Markdown HTML 渲染输出
Italicized text is the *cat's meow*. Italicized text is the cat's meow. 斜体文字是猫的叫声。
Italicized text is the _cat's meow_. Italicized text is the cat's meow. 斜体文字是猫的叫声。
A*cat*meow Acatmeow 一个猫喵

粗体和斜体

要同时突出显示带有粗体和斜体的文本，请在单词或短语的前后添加三个星号或下划线。

Markdown HTML 渲染输出
This text is ***really important***. This text is really important. 这段文字*真的很重要*。
This text is ___really important___. This text is really important. 这段文字*真的很重要*。
This text is __*really important*__. This text is really important. 这段文字*真的很重要*。
This text is **_really important_**. This text is really important. 这段文字*真的很重要*。

块引用

要创建blockquote，请>在段落前面添加一个。

> Dorothy followed her through many of the beautiful rooms in her castle.

呈现的输出如下所示：

桃乐丝（Dorothy）跟着她走过了她城堡中许多美丽的房间。

具有多个段落的块引用

块引用可以包含多个段落。>在段落之间的空白行上添加一个。

> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

呈现的输出如下所示：

桃乐丝（Dorothy）跟着她走过了她城堡中许多美丽的房间。

女巫请她清洗锅碗瓢盆，扫地，并用木柴取火。

嵌套块引用

块引用可以嵌套。>>在要嵌套的段落前面添加一个。

> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

呈现的输出如下所示：

桃乐丝（Dorothy）跟着她走过了她城堡中许多美丽的房间。

女巫请她清洗锅碗瓢盆，扫地，并用木柴取火。

具有其他元素的块引用

块引用可以包含其他Markdown格式的元素。并非所有元素都可以使用-您需要进行实验以查看哪些元素有效。

> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.

呈现的输出如下所示：

季度业绩看起来不错！

收入超出了预期。利润比以往任何时候都高。

一切都按计划进行。

清单

您可以将项目组织成有序和无序列表。

有序列表

要创建有序列表，请在订单项中添加数字和句点。数字不必按数字顺序排列，但列表应以数字开头。

Markdown HTML 渲染输出
1. First item
2. Second item
3. Third item
4. Fourth item

  1. First item

  2. Second item

  3. Third item

  4. Fourth item

    		5.  1. First item
    2. Second item
    3. Third item
    4. Fourth item
    1. First item
    1. Second item
    1. Third item
    1. Fourth item

    1. First item

    2. Second item

    3. Third item

    4. Fourth item

      		5.  1. First item
      2. Second item
      3. Third item
      4. Fourth item
      1. First item
      8. Second item
      5. Third item
      3. Fourth item

      1. First item

      2. Second item

      3. Third item

      4. Fourth item

        		5.  1. First item
        2. Second item
        3. Third item
        4. Fourth item
        1. First item
        2. Second item
        3. Third item
        1. Indented item
        2. Indented item
        4. Fourth item

        1. First item

        2. Second item

        3. Third item


          1. Indented item

          2. Indented item


          3. Fourth item

            		4.  1. First item
            2. Second item
            3. Third item
            1. Indented item
            2. Indented item
            4. Fourth item

            无序列表

            要创建无序列表，请在订单项前添加破折号（-），星号（*）或加号（+）。缩进一个或多个项目以创建嵌套列表。

            Markdown HTML 渲染输出
            - First item
            - Second item
            - Third item
            - Fourth item

            • First item

            • Second item

            • Third item

            • Fourth item

              		•  - First item
              - Second item
              - Third item
              - Fourth item
              * First item
              * Second item
              * Third item*
              * Fourth item

              • First item

              • Second item

              • Third item

              • Fourth item

                		•  * First item
                * Second item
                * Third item
                * Fourth item
                + First item
                * Second item
                - Third item
                + Fourth item

                • First item

                • Second item

                • Third item

                • Fourth item

                  		•  + First item
                  * Second item
                  - Third item
                  + Fourth item
                  - First item
                  - Second item
                  - Third item
                  - Indented item
                  - Indented item
                  - Fourth item

                  • First item

                  • Second item

                  • Third item


                    • Indented item

                    • Indented item


                    • Fourth item

                      		•  - First item
                      - Second item
                      - Third item
                      - Indented item
                      - Indented item
                      - Fourth item

                      在列表中添加元素

                      要在保留列表连续性的同时在列表中添加另一个元素，请将该元素缩进四个空格或一个制表符，如以下示例所示。

                      段落

                      *   This is the first list item.
*   Here's the second list item.

    I need to add another paragraph below the second list item.

*   And here's the third list item.

                      呈现的输出如下所示：

                      • 这是第一个列表项。
                      • 这是第二个列表项。我需要在第二个列表项下面添加另一段。
                      • 这是第三个列表项。