Markdown拾遗

语法记录

标题

为了兼容考虑，请在井号和标题文本之间添加一个空格

段落

要创建段落，请使用空白行将一行或多行文本进行分隔。

换行

在一行的末尾添加两个或多个空格，然后按回车键，即可创建一个换行
例如本行是一个新行

这是一个新段落

加粗

在单词或短语的前后各添加 两个星号

斜体

在单词或短语前后添加 一个星号

斜体加粗

在要突出显示的部分前后各添加 三个星号

块引用

请在段落前添加一个 > 符号

块引用

块引用可以包含多个段落。为段落之间的空白行各添加一个 > 符号。

块引用1

块引用2

带有其它元素的块引用

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

列表

不要在同一个列表中混用不同的分隔符

缩进一个或多个列表项可创建嵌套列表

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

如果你需要以数字开头并且紧跟一个英文句号（也就是 .）的无序列表项，则可以使使用反斜线（\）来 转义 这个英文句号。

• 1968. A great year!
• I think 1969 was second best.

要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格，例如

• 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.

或者

• This is the first list item.

• Here’s the second list item.

  A blockquote would look great below the second list item.

• And here’s the third list item.

代码

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。

围栏代码块

代码块的前后可以使用三个反引号（```）。

链接

要创建链接，请将链接文本括在方括号（例如 [Duck Duck Go]）中，后面紧跟着括在圆括号中的 URL（例如 (https://duckduckgo.com) ）。

My favorite search engine is [Duck Duck Go](https://duckduckgo.com).

网址和电子邮件地址

要将 URL 或电子邮件地址快速转换为链接，请将其括在尖括号中。

图片

感叹号中括号（描述）小括号（位置）

![Tux, the Linux mascot](/assets/images/tux.png)

表格

请使用三个或更多个连字符（—）来为每个列创建表头，并使用管道符（|）来分隔每个列。

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

通过在标题行中的连字符（hyphens）的左侧或右侧或两侧添加冒号（:），可以将对应列中的文本向左或向右或居中对齐。

| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

任务列表

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

高亮

I need to highlight these <mark>very important words</mark>.
或者==高亮==

上下标

下标

H~2~O

上标

X^2^

脚注

Here's a sentence with a footnote. <sup id="fnref:1" class="footnote-ref"><a href="#fn:1" rel="footnote"><span class="hint--top hint--rounded" aria-label="This is the footnote.">[1]</span></a></sup>

参考资料

Markdown 指南中文版

1. This is the footnote.
   ↩