2025-04-05

Markdown Test

标题

使用一至六个 # 创建不同等级的标题。

# A first-level heading

## A second-level heading

### A third-level heading

二级标题和三级标题会自动生成目录,可以单击某个标题导航到所选部分。

文本样式

可以在文本中以粗体、斜体或删除线表示强调。

StyleSyntaxExampleOutput
Bold** ** or __ __**This is bold text**This is bold text
Italic* * or _ __This text is italicized_This text is italicized
Strikethrough~~ ~~ or ~ ~~~This was mistaken text~~This was mistaken text
Bold and nested italic** ** and _ _**This text is _extremely_ important**This text is extremely important
All bold and italic*** *** or **_ _****_All this text is important_**All this text is important

段落与换行

如果在两行之间留出空白行,将创建新的段落:

This example

Will have a blank line separating both lines

This example

Will have a blank line separating both lines

若要在 markdown 中换行,可以使用以下两种方法:

  • 在要换行处使用反斜杠;

    This example\
    Will span two lines
  • 在要换行处使用 <br/> 标签。

    This example<br/>
    Will span two lines

This example
Will span two lines

分隔线

分隔线语法使用三个连续的 -、* 或 _ 符号。

---

链接

通过将链接文本用方括号 [ ] 括起来,然后将 URL 用括号 ( ) 括起来,可创建内联链接。

This site was built using [React](https://react.dev/).

This site was built using React.

列表

可通过在一行或多行文本前面加上 -、* 或 + 来创建一个无序列表。

- George Washington
- John Adams
- Thomas Jefferson
  • George Washington
  • John Adams
  • Thomas Jefferson

在每行前面添加一个编号以创建有序列表。

1. James Madison
2. James Monroe
3. John Quincy Adams
  1. James Madison
  2. James Monroe
  3. John Quincy Adams

嵌套列表

通过在一个列表项下面缩进一个或多个其他列表项,可创建嵌套列表。

1. First list item
   - First nested list item
     - Second nested list item
  1. First list item
    • First nested list item
      • Second nested list item

任务列表

若要创建任务列表,可在列表项前加连字符和空格,后接 [ ]。要将任务标记为完成,使用 [x]。

- [x] #739
- [ ] \(Optional) Open a followup issue
  • #739
  • (Optional) Open a followup issue

图片

通过使用 ! 并将 alt 文本用 [ ] 括起来,可显示图片。替换文字是等效于图片中信息的短文本。然后将图片的链接用括号 ( ) 括起来。

![alt text](https://example.com/picture)

引用文本

使用 > 创建引用文本。

Text that is not a quote

> Text that is a quote

Text that is not a quote

Text that is a quote

引用文本向右缩进,带有一个垂直线,并使用灰色字体显示。

多段落引用

对于多个段落的引用,每个段落间需要添加一个 > 。

> 这是一个引用文本,当前在第一段。
>
> 这是一个引用文本,当前在第二段。

这是一个引用文本,当前在第一段。

这是一个引用文本,当前在第二段。

嵌套引用

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

> 这是一个引用文本。
>
> > 这是一个嵌套引用文本。

这是一个引用文本。

这是一个嵌套引用文本。

警报

警报是基于引用语法的扩展,用于强调关键信息。以独特的颜色和图标显示,以指示内容的显著性。

只有在对成功至关重要时才使用警报,并将每篇文章的警报限制在一到两个。此外,应避免连续发出警报。警报无法嵌套在其他元素中。

要添加警报,请使用指定警报类型的特殊块引用行,然后在标准块引用中添加警报信息。可以使用以下五种类型的警报:

> [!NOTE]
> Useful information that users should know, even when skimming content.

> [!TIP]
> Helpful advice for doing things better or more easily.

> [!IMPORTANT]
> Key information users need to know to achieve their goal.

> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.

> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
Note

Useful information that users should know, even when skimming content.

Tip

Helpful advice for doing things better or more easily.

Important

Key information users need to know to achieve their goal.

Warning

Urgent info that needs immediate user attention to avoid problems.

Caution

Advises about risks or negative outcomes of certain actions.

代码

使用单反引号可标注句子中的代码或命令。反引号中的文本不会被格式化。

Use `git status` to list all new or modified files that haven't yet been committed.

Use git status to list all new or modified files that haven't yet been committed.

代码块

通过在代码块的前后输入连续三个反引号,可创建代码块。要在代码块中显示三个反引号,将代码块包在四个反引号内。

添加可选的小写的语言标识符,以在代码块中启用语法高亮。语法高亮功能会更改源代码的颜色和样式,使其更易于阅读。

例如,要对 JavaScript 代码进行语法高亮:

```javascript
function print(str) {
  console.log(str);
}
print("hello");
```
function print(str) {
  console.log(str);
}
print("hello");

在代码行后添加注释 [!code ++][!code --][!code highlight] 来标记增删的行或对行进行高亮。

console.log("line");
console.log("add line"); // [!code ++]
console.log("remove line"); // [!code --]
console.log("highlight line"); // [!code highlight]

表格

使用三个或更多连字符 - 创建表头,使用管道符号 | 分隔列。

| First Header | Second Header | Third Header |
| ------------ | ------------- | ------------ |
| Content Cell | Content Cell  | Content Cell |
| Content Cell | Content Cell  | Content Cell |
First HeaderSecond HeaderThird Header
Content CellContent CellContent Cell
Content CellContent CellContent Cell

可以在连字符 - 左侧、右侧或两侧添加冒号 : 对该列左对齐、右对齐或居中对齐。

| Align Left   | Align Center |  Align Right |
| :----------- | :----------: | -----------: |
| Content Cell | Content Cell | Content Cell |
| Content Cell | Content Cell | Content Cell |
Align LeftAlign CenterAlign Right
Content CellContent CellContent Cell
Content CellContent CellContent Cell

折叠部分

使用 details 元素实现对部分内容的折叠。

<details>

<summary>点击展开</summary>

被折叠的文本段1。

被折叠的文本段2。

</details>
点击展开

被折叠的文本段1。

被折叠的文本段2。

对多个连续的 details 添加相同的 name 属性,可以实现手风琴效果,即同时只会展开一个项目。

数学表达式

内联表达式

使用美元符号 $ 将表达式括起来即可创建内联表达式。当正在编写的表达式包含与 markdown 语法重叠的字符时,可以在表达式开头使用 $`,并在表达式结尾使用 `$。

This sentence uses \$ delimiters to show math inline: $`\sqrt{3x}+(1+x)^2`$

This sentence uses $ delimiters to show math inline: 3x+(1+x)2`\sqrt{3x}+(1+x)^2`

块表达式

使用一对 $$ 符号创建块表达式。

$$
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
$$
(k=1nakbk)2(k=1nak2)(k=1nbk2)\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)

也可以使用代码块语法并声明语言为 math 将数学表达式显示为块。

```math
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```
(k=1nakbk)2(k=1nak2)(k=1nbk2)\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)

脚注

可以使用此括号语法为内容添加脚注:

Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference.

[^2]: To add line breaks within a footnote, usr `<br/>` tag.<br/>This is a second line.

Here is a simple footnote1.

A footnote can also have multiple lines2.

Markdown 中脚注的位置不会影响该脚注的呈现位置。可以在引用脚注后立即写脚注,脚注仍将呈现在 Markdown 的底部。

自定义定位点

可使用标准 HTML 定位点标记 () 为文档中的任何位置创建导航定位点。为了避免不明确的引用,请对定位点标记使用唯一的命名方案,例如向 name 属性值添加前缀。

定位点不会包含在目录中。

可使用为定位点提供的 name 属性的值链接到自定义定位点。语法与链接到为标题自动生成的定位点时完全相同。

For example:

Some body text of this section.

<a name="my-custom-anchor-point"></a>Some text I want to provide a direct link to, but which doesn't have its own heading.

(… more content…)

[A link to that custom anchor](#my-custom-anchor-point)

Some body text of this section.

Some text I want to provide a direct link to, but which doesn't have its own heading.

(… more content…)

A link to that custom anchor

忽略 Markdown 格式

通过在 Markdown 字符前面输入 \,可忽略 Markdown 格式(或对其进行转义)。

Let's rename \*our-new-project\* to \*our-old-project\*.

Let's rename *our-new-project* to *our-old-project*.

Footnotes

  1. My reference.

  2. To add line breaks within a footnote, usr <br/> tag.
    This is a second line.