Markdown 支持清单

每条语法：写法、渲染结果，以及它在终端浏览器（w3m / lynx）里读成什么。

• 发布于 2026-09-21
• 修订 2026-09-22
• 学习笔记

• Markdown
• 写作
• 终端

标题

```markdown
## 二级标题
```

二级标题

```markdown
### 三级标题
```

三级标题

```markdown
#### 四级标题
```

四级标题

```markdown
##### 五级标题
```

五级标题

```markdown
###### 六级标题
```

六级标题

终端：w3m 给每个标题前后各留一个空行，不按层级缩进，三级以下彼此分不出来；lynx 每级缩进两格，层级看得见。

自定义锚点

```markdown
### 一个不跟着文字改的锚点 {#stable-anchor}
```

一个不跟着文字改的锚点

终端：HTML 里是 `id="stable-anchor"`，改标题文字不影响这个锚点。

行内标记

粗体 斜体 删除线 `行内代码` 上标² 下标_n

```markdown
**粗体** *斜体* ~~删除线~~ `行内代码` 上标^2^ 下标~n~
```

转义：*这一对星号不是斜体*。实体：© —  （不间断空格）。

终端：粗体、斜体、`<mark>`、`<kbd>` 的样式全部消失；删除线读作 `[DEL:删除线:DEL]`，上标读作 `^2`，下标读作 `[n]`（lynx 的方括号里多两个空格）；行内代码多出一对反引号。

链接

站内链接：全部文章。站外链接：Sätteri 的仓库。自动链接：https://astro.build。

终端：只有链接文字，看不到地址；但链接本身能跳转 —— w3m 里 Tab 选中、回车跟随（实测从本页的自动链接跳到了 astro.build）。

列表

```markdown
- 第一项
- 第二项
```

• 第一项
• 第二项，里面可以放 `代码` 与粗体

```markdown
1. 第一步
2. 第二步
```

1. 第一步
2. 第二步

```markdown
- 上层
    - 下层用四个空格缩进
```

• 上层
  • 下层用四个空格缩进
  • 第二项

```markdown
- [x] 已经做完的事
- [ ] 还没做的事
```

• 已经做完的事
• 还没做的事

终端：无序是 `•`，有序保留 `1. 2.`，嵌套第二层是 `□`。

引用与提示框

```markdown
> 引用里的第一段。
>
> 引用里的第二段。
```

引用里的第一段。

引用里的第二段。

```markdown
> [!NOTE]
> 这类框用来放补充说明。
```

提示

这类框用来放补充说明。

```markdown
> [!TIP]
> 这类框用来放技巧。
```

技巧

这类框用来放技巧。

```markdown
> [!IMPORTANT]
> 这类框用来放重要的事。
```

重要

这类框用来放重要的事。

```markdown
> [!WARNING]
> 这类框用来放容易踩的坑。
```

注意

这类框用来放容易踩的坑。

```markdown
> [!CAUTION]
> 这类框用来放警告。
```

警告

这类框用来放警告。

终端：块引用缩进四格，标题是一行真文字。

代码

```markdown
```bash
systemctl --user status kde-theme-sync.path
```
```

```bash
systemctl --user status kde-theme-sync.path
```

```markdown
```
没有语言标签的代码块。
```
```

```plaintext
没有语言标签的代码块，Shiki 按 plaintext 处理。
```

```bash
journalctl --user -u wireplumber --since '14 days ago' | grep -iE 'lua|not supported|error' | tail -40
```

```plaintext
这一行是四个空格缩进的代码块
渲染结果与不带语言的围栏一致
```

终端：上下各注入一行围栏，语言标签补在开围栏上；超长行要按 `>` 横向移动才能看全。

表格

终端：不画表格线，靠列对齐；自然宽（汉字算两列、列间一个空格）超过 79 列就会折行，而折行之后读不出哪一格属于哪一列。宽表格改写成列表：

• 现象 —— 完全不生效
  • 可能原因：`kde-theme-sync.path` 没启用
  • 怎么办：`systemctl --user status kde-theme-sync.path`

脚注

这句话带一个脚注¹。

终端：脚注编号与文末列表都保留。

图片

终端：只读得到 `alt` 文字，上面这张图读作「站点的分隔线图形」。

数学

```markdown
行内：$a^2 + b^2 = c^2$
```

行内：$a^2+b^2=c^2$

```markdown
$$
\int_0^1 x^2 \, dx = \frac{1}{3}
$$
```

终端：公式只剩一串字符。行内读作 `a2+b2=c2`；块级读作 `∫01x2dx=31` —— 上下标、分式、根号在终端里全被拍平成字符顺序，KaTeX 的 MathML 那一层会让 lynx 直接吐出 XML 源码，所以构建期只输出 HTML。

定义列表

术语

解释。缩进加不加都行，处理器认的是行首的 `: `。

终端浏览器

块引用缩进、列表缩进、定义列表缩进。

终端：术语一行，解释缩进四格。

分隔线与原始 HTML

原始 HTML 原样保留：按 Ctrl 切换键盘，高亮的一段。

术语

解释。

终端：`<kbd>` 与 `<mark>` 的样式消失，`<dl>` 是术语一行、解释缩进四格。

不支持的写法

• 冒号围栏 `:::note`：整块内容被静默丢掉，什么都不剩。替代品是 `> [!NOTE]`。
• `[[双链]]`：开关关闭，开了只会生成死链。
• 图表：Mermaid 之类需要客户端 JS，不支持。

全部文章