知屿 Markdown 语法说明

作者：姚博文 · 2026-08-12

知屿 Markdown 语法说明

知屿的笔记支持一套丰富的 Markdown 语法，在 **Docs 阅览室 / 笔记阅读 / 编辑区** 三处渲染一致（个别能力有范围差异，已在文中标注）。以下按能力逐项说明，每条都给出「写法」与「效果」。

· * *

1\. 基础语法

| 能力 | 写法 | 效果 |

| --- | --- | --- |

| 标题 | # 一级、## 二级 … ###### 六级 | 各级标题 |

| 加粗 | 加粗 | 加粗 |

| 斜体 | 斜体 | 斜体 |

| 删除线 | 删除 | 删除 |

| 行内代码 | code | code |

| 链接 | 文字 | 文字 |

| 无序列表 | - 项 / * 项 | • 项 |

| 有序列表 | 1. 项 2. 项 | 1. 项 2. 项 |

| 引用 | > 内容 | 引用块 |

| 分割线 | --- | 水平线 |

| 任务列表 | - [ ] 待办 - [x] 完成 | ☐ 待办 ☑ 完成 |

· * *

2\. 表格（GitHub 风格）

**写法**

**效果**

| 列1 | 列2 | 列3 |

| --- | --- | --- |

| 左对齐 | 居中 | 右对齐 |

| a | b | c |

对齐方式：`:---` 左对齐、`:---:` 居中、`---:` 右对齐。

· * *

3\. Emoji

**写法**：`:tada: :100: :heart:`

**效果**：🎉 💯 ❤️

完整表情列表见 [markdown-it-emoji](https://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.mjs)。

· * *

4\. 代码块

4.1 语法高亮

**写法**

const greet = (name) => `Hello, ${name}!`

**效果**

语言写在围栏后（`js` / `html` / `python` / `ts` / `css` …），支持 highlight.js 全部语言；代码块右上角有复制按钮，头部显示语言名。

4.2 行高亮

在围栏语言后加 `{行号}` 即可高亮指定行。

**写法**

const a = 1

const b = 2 // ← 第 2 行高亮

const c = 3

const d = 4

const e = 5 // ← 第 5、6 行高亮

const a = 1

const b = 2 // ← 第 2 行高亮

const c = 3

const d = 4

const e = 5 // ← 第 5、6 行高亮

def hello():

print('hi')

print('从第 10 行开始编号')

::: code-group