# Heading 1

一级标题。ATX 风格,前面一个 `#`。

## Heading 2

段落标题。

### Heading 3

子段落标题。最多 6 级(`######`)。

Big title
=========

Smaller title
-------------

另一种标题写法:`===` 下划线表 H1,`---` 表 H2。

注意: Only H1 and H2 supported in Setext form.

A paragraph is just text
with a soft wrap.

Blank line starts new paragraph.

空行分隔的纯文本就是段落。

**bold text** or __bold text__

用两个 `*` 或两个 `_` 包起来。

*italic* or _italic_

单个 `*` 或 `_`。词中间最好别用 `_`,容易踩坑。

***bold italic*** or **_mixed_**

三个 `*`,或 `**` 与 `_` 组合。

---

or

***

or

___

单独一行三个以上 `-`、`*` 或 `_`。

line one  
line two

行尾加两个空格强制段内换行。

注意: Or use a `\` backslash at end of line.

\*literal asterisks\* and \_underscores\_

在特殊字符前加反斜杠,按字面渲染。

## Setup {#install}

部分渲染器(GitLab、kramdown、Pandoc)支持 `{#id}` 覆盖自动生成的 slug。

注意: Not GFM. GitHub ignores the braces and renders them as text.

line one
line two becomes one line

blank line splits paragraphs

单个换行是软换行,会合成同一行。空行才分段。

un**believ**able

`**` 在词中间有效,`__` 无效。CommonMark 里词内的 `_` 按字面处理。

A literal backtick: \`

代码区外,反斜杠可转义反引号。

- - -

or

* * *

分割线的三个字符之间可以带空格。

line one\
line two

行尾反斜杠强制硬换行,比两个空格更显眼。

注意: CommonMark and GFM support it; some older parsers do not.

- apple
- banana
- cherry

`-`、`*` 或 `+` 后接空格。

1. first
2. second
3. third

数字加 `.`。其实全写 `1.` 也行,渲染器会自动编号。

- top
  - nested
    - deeper
- back to top

嵌套缩进 2 空格(CommonMark)或 4 空格(部分方言)。

1. ordered
   - bullet
   - bullet
2. ordered

不同缩进可混合 `1.` 与 `-`。

5. five
6. six
7. seven

第一个数字决定起点,后续自动从它顺延。

1) first
2) second

CommonMark 也接受 `)` 作为有序列表分隔符,不只是 `.`。

- item one

- item two

- item three

条目间留空行变松散列表,每条会被包进 `<p>`。

1. First paragraph.

   Second paragraph, indented 3 spaces.
2. Next item.

后续段落缩进对齐到条目正文,才算同一条。

- step:

  ```sh
  npm run build
  ```

围栏代码块缩进到条目下(空行加对齐)即可嵌套。

Term
: Definition of the term
: Second definition

Pandoc/kramdown/PHP Markdown Extra:术语加 `:` 行。CommonMark/GFM 不支持。

注意: GitHub renders this as plain text.

[Toolora](https://toolora.com)

最常用的形式。文本放 `[]`,URL 放 `()`。

[Toolora](https://toolora.com "Tooltip")

URL 后的引号字符串作为悬浮提示。

Visit [Toolora][site] today.

[site]: https://toolora.com "Tooltip"

URL 在别处定义。同一 URL 反复出现或太长时好用。

<https://toolora.com> or <hi@toolora.com>

裸 URL 或邮箱用 `<>` 包起来,自动变可点击。

![alt text](https://toolora.com/logo.png)

类似链接,前面加 `!`。`alt` 在图加载失败时显示。

![alt](https://toolora.com/logo.png "Logo")

引号里的标题作为悬浮提示。

![logo][img]

[img]: https://toolora.com/logo.png

图片的引用式写法,与引用式链接结构相同。

Read the [docs][].

[docs]: https://toolora.com/docs

空 `[]` 直接用链接文本作为引用标签。

See [the readme](./README.md) and [a section](../docs/setup.md#install).

相对路径在多数平台按当前文件位置解析。

[![alt](icon.png)](https://toolora.com)

把图片放进链接里,图片就可点击。

[Email us](mailto:hi@toolora.com)

在普通行内链接里用 `mailto:` URL,点击后打开邮件客户端。

![build](https://img.shields.io/badge/build-passing-brightgreen)

徽章本质就是指向 shields.io 这类服务的图片。

Run `npm install` then go.

反引号包起来。

Use `` `code` `` if your code contains a backtick.

双反引号包裹,内部可含单个反引号。

```
const x = 1;
console.log(x);
```

单独一行三个反引号,前后包裹多行代码。

```js
const x = 1;
console.log(x);
```

在开头围栏后写语言名,启用语法高亮。

~~~python
print("hi")
~~~

`~~~` 是另一种围栏写法。代码里要写三个反引号时好用。

Normal paragraph.

    indented 4 spaces
    is a code block

缩进 4 空格(或 1 个 Tab)。老语法,推荐用围栏。

````
```
nested fence shown literally
```
````

更长的围栏可以包住内部本身含三反引号的代码。

`` `a` ``

首尾各一个空格会被去掉,从而让代码以反引号开头或结尾。

```diff
- old line
+ new line
```

`diff` 语言在 GitHub 上把 `+`/`-` 行染成绿色和红色。

```mermaid
graph TD
  A --> B
  B --> C
```

GitHub 与 GitLab 把 ` ```mermaid ` 块渲染成图表。

注意: Plain CommonMark shows it as a code block.

```json
{
  "name": "toolora",
  "private": true
}
```

围栏标 `json`,键值对会高亮。

| Name | Age |
| ---- | --- |
| Alice | 30 |
| Bob | 25 |

用管道符分列,必须有分隔行。

注意: GFM extension. CommonMark does not include tables.

| Left | Center | Right |
| :--- | :----: | ----: |
| a    | b      | c     |

分隔行用 `:` 控制对齐:`:---` 左,`:---:` 居中,`---:` 右。

| Name | Link |
| ---- | ---- |
| **bold** | [site](https://x.com) |

单元格支持行内格式:加粗、斜体、链接、行内代码。

注意: Block content (lists, fenced code) is NOT allowed in pipe-table cells.

| Name | Code |
| ---- | ---- |
| or   | a \| b |

`\|` 表示字面管道符。

| A | B | C |
| - | - | - |
| 1 | 2 |
| 1 | 2 | 3 | 4 |

行不够的列补空,多出来的列被丢弃。

| A | B |
| - | - |
| 1 | 2 |

分隔行每列一个 `-` 就够了。

A | B
--- | ---
1 | 2

GFM 表格里首尾的 `|` 可省略。

| Item | Notes |
| ---- | ----- |
| A | line1<br>line2 |

单元格内换行用 `<br>`,直接敲回车不行。

> This is a quote.
> Wrapped onto a second line.

每行前面加 `>`。

> Outer quote
> > Inner quote
> back to outer

`> >` 表嵌套。

> ## Quoted heading
>
> Paragraph with **bold**.
>
> - list item

块引用内可包含任何 Markdown 块级元素。

> First line
still the same quote

紧跟 `>` 行之后的行,即使没有 `>` 也并入同一引用。

> Run this:
>
> ```sh
> npm ci
> ```

围栏代码每行都加 `>`,才留在引用内。

> [!NOTE]
> Useful information.

> [!WARNING]
> Be careful here.

GitHub 把 `[!NOTE]`、`[!TIP]`、`[!IMPORTANT]`、`[!WARNING]`、`[!CAUTION]` 渲染成彩色提示框。

注意: GitHub-specific. Other renderers show a plain blockquote.

Press <kbd>Ctrl</kbd>+<kbd>C</kbd> to copy.

行内 HTML 标签原样透传。

<details>
<summary>Click to expand</summary>

Hidden content.

</details>

块级 HTML 原样透传。常用于 `<details>`、`<table>`。

注意: Many renderers sanitize away <script>, <style>, <iframe>, on* handlers.

<!-- This is a comment, not rendered. -->

HTML 注释会被剥掉,不渲染。常用作 TODO 标注。

H<sub>2</sub>O and E = mc<sup>2</sup>

Markdown 没有原生写法,用 `<sub>` 和 `<sup>`。

<details open>
<summary>Shown expanded</summary>

Content.

</details>

给 `<details>` 加 `open` 属性,初始就是展开状态。

<div>

**This is bold** inside a div.

</div>

开标签后留空行,块内的 Markdown 才会被解析。

注意: Without the blank line, the inner text is treated as raw HTML.

~~struck through~~

两边各两个 `~`。GFM 扩展。

注意: Not in CommonMark spec — GFM/GitLab/Bitbucket all support.

- [ ] todo
- [x] done
- [ ] another

`- [ ]` 未完成,`- [x]` 已完成。GFM 扩展。

注意: GitHub/GitLab/Bitbucket render checkboxes; CommonMark renders as text.

Just paste https://toolora.com — GFM auto-links.

GFM 扩展:裸 URL 不需要 `<>` 也自动变链接。

注意: CommonMark requires `<>`. GitHub/GitLab/Bitbucket auto-link without.

Here is a claim.[^1]

[^1]: Citation goes here.

行内引用 + 文末脚注定义。GFM/GitLab 支持。

注意: CommonMark does not include footnotes. Bitbucket does not support.

cc @octocat please review

`@user` 自动变成用户链接。仅 GitHub 支持。

Fixes #42 and closes owner/repo#7

`#123`、`owner/repo#123` 自动链到 issue。GitHub/GitLab 支持。

I :heart: Markdown :sparkles:

`:名称:` 渲染为 emoji。GitHub 专属。

注意: Renders literally on non-GitHub viewers.

- [x] parent done
  - [ ] child todo
  - [x] child done

子任务复选框缩进到父项下即可嵌套。

Claim one.[^a] Claim two.[^b]

[^a]: First note.
[^b]: Second note.

脚注标签可以是任意标识符,不只是数字,输出会按顺序重新编号。

Visit www.toolora.com for tools.

GFM 自动识别裸 `www.` 域名,并补上 `http://`。

注意: CommonMark does not auto-link www-only hosts.

Fixed in a1b2c3d and owner/repo@f4e5d6c

GitHub 自动链接 7 位以上的提交哈希,也支持 `owner/repo@sha`。

Ship it 🚀 — works everywhere.

直接粘贴的 Unicode emoji 在所有查看器都能显示,不像 `:短码:`。

# Heading

Paragraph with [link](url) and `code`.

最严格的基线规范。无表格、无任务列表、无删除线、无脚注。

CommonMark + tables + task lists + ~~strike~~ + autolinks + emoji + @mentions + #refs

CommonMark 超集。增加表格、任务列表、删除线、自动链接、emoji、@ 提及、#issue 引用。

GFM + math via $...$ + diagrams + video/audio embeds

GFM 超集。增加 `$...$` 数学公式、mermaid 流程图、视频音频嵌入、MR 引用。

CommonMark base + anchor prefix: #markdown-header-my-heading

接近 CommonMark。锚点用 `markdown-header-` 前缀,GFM 风格的文档内链接会失效。

See [Setup](#setup) below.

## Setup

标题自动生成 `id` slug,用 `#slug` 链接。各家 slug 规则不同。

![Demo](demo.mp4)

GitLab 把视频格式渲染为 `<video>` 播放器。GitHub/Bitbucket 会渲染成坏图。

Inline: $E = mc^2$

Block:
```math
\sum_{i=1}^n i = \frac{n(n+1)}{2}
```

GitLab 支持 `$...$` 行内与 ` ```math ` 块。GitHub 从 2022 起也支持 `$...$`。

---
title: My Post
date: 2026-05-30
---

Body starts here.

Jekyll、Hugo、Astro、11ty 会读取 `---` 包裹的 YAML 块作为元数据。

注意: Plain CommonMark renders the first `---` as a horizontal rule.

[[_TOC_]]

GitLab 在 `[[_TOC_]]` 处插入自动目录(部分平台用 `[TOC]`)。

注意: GitHub renders its own TOC from the file outline, no marker needed.

This is ==highlighted== text.

Obsidian、Pandoc 等把 `==text==` 渲染为 `<mark>`。GFM 不支持。

[[Page Name]] and [[Page Name|display text]]

Obsidian、GitHub wiki、DokuWiki 用 `[[...]]` 按页面标题链接。

注意: Not part of CommonMark or GFM document Markdown.

> [!info] Title
> Body of the callout.

Obsidian 用 `[!type]` 扩展块引用为 callout(info、tip、warning 等)。

[//]: # (This is an invisible comment.)

未被使用的链接引用定义不会渲染,可当作跨平台注释。