Markdown 排版指南：本站写作语法速查

写文章时最打断心流的事，莫过于「这个效果支持吗？语法是什么？」。这篇指南把本站支持的排版语法一次性整理清楚，每个例子都是实时渲染的真实效果，可以当速查表用。

提示块：五种彩色警告块#

在引用块第一行写 [!类型] 即可，标题可自定义（[!NOTE/我的标题]）：

> [!NOTE]
> 强调读者应该关注的信息。

> [!TIP/小技巧]
> 标题可以换成自己的话。

> [!IMPORTANT]
> 用户必须知道的关键信息。

> [!WARNING]
> 紧急程度不高，但不遵守可能出问题。

> [!CAUTION]
> 不这么做会带来负面后果。

渲染效果：

这套语法与 GitHub、Obsidian 完全兼容：在 Obsidian 里写作时直接预览，粘贴到 GitHub 也原样渲染。

代码块#

基础写法与自动装饰#

```ts
const answer = 42
```

每个代码块自动附带：明暗双主题语法高亮（跟随站点主题）、行号、右上角语言标签、悬停出现的复制按钮；超过 15 行自动折叠，点击展开。

给代码块起标题#

```log title="hello.log"
test
```

值必须带引号。效果：

test

行号高亮（推荐）#

把行号写在语言后面的花括号里，代码内容保持干净：

```ts {2,4-5}
function greet(name: string) {
  const message = `Hello, ${name}!`
  console.log(message)
  return message
}
```

渲染效果（第 2、4、5 行高亮）：

function greet(name: string) {
  const message = `Hello, ${name}!`
  console.log(message)
  return message
}

diff 对比#

直接用 diff 语言，行首 + / - 标记增删：

```diff
- const port = 3000
+ const port = process.env.PORT ?? 3000
```

- const port = 3000
+ const port = process.env.PORT ?? 3000

进阶：注释标记法#

把标记写进代码注释里，适合「高亮某一行并说明原因」的场景，标记渲染时自动隐藏：

• // [!code highlight] 或 // [!code hl]：高亮当前行
• // [!code ++] / // [!code --]：标记新增 / 删除行
• // [\!code ...]：需要字面展示时转义

def transfer(src, dst):
    validate(src)              
    dst.write(src.read())      
    # legacy_copy(src, dst)    

数学公式#

行内公式 $E = mc^2$，块级公式用双美元符号：

基础排版速查#

表格支持横向滚动；图片自动居中、圆角，点击可放大。

写作规范#

文章 frontmatter 字段与约束：

几个建议：

• 标题层级从 ## 开始（# 留给文章标题），层级不跳档；
• 每篇文章开头放一条 [!NOTE/AI 速读] 提示块，50 字以内概括全文；
• 超过 15 行的代码考虑拆段讲解，别让折叠按钮替你藏问题；
• 转载或参考他人内容时，在文末用提示块注明出处。