本文系统梳理本站代码块集成的各项功能规范与排版细节。除代码块右上角工具栏提供的交互按键外,绝大部分增强功能均基于标准的 Markdown 写作扩展语法——日常行文无需繁复配置,在围栏代码块(Fenced Code Blocks)中声明属性即可直接生效。

文件名与标题

在代码块语言标识后紧跟 title="文件名" 参数,顶部标题栏即可显式展示具体文件名,用以替代默认的语言类型标签:

server.ts
import { createServer } from "node:http";
createServer((req, res) => {
res.writeHead(200, { "content-type": "text/plain" });
res.end("hello world\n");
}).listen(8080);

行内文本标记

借助 Expressive Code 提供的语义标记体系,只需在目标代码行尾附加 // [!code ...] 指令注释,即可按规范输出行内强调:

ts
function fetchUser(id: number) {
if (id <= 0) {
return Promise.reject(new Error("invalid id")); // [!code --]
}
return fetch(`/api/users/${id}`).then((r) => r.json()); // [!code mark]
}
标记含义
[!code mark]默认标记色(行尾高亮)
[!code ++] / [!code --]diff 新增 / 删除(同 +/-,也可用 add/rem)

注意:highlight 是 Expressive Code 的内部别名(对应 mark),正文写作 mark 即可;del/ins 与 rem/add 互换使用。

行内标记只有 mark / ins / del 三种语法着色(EC 0.42):warn / error 不存在,不要照搬其它主题的写法。

Diff 视图

直接声明 diff 语言即可:

diff
const port = 8080;
const port = Number(process.env.PORT ?? 8080);

终端与 macOS 视效

本站所有代码块均赋予拟物化 macOS 窗口质感,并在标题栏左上角渲染标准的红黄绿三色控制按钮(支持悬停浮现专属微图标,并可点击进行折叠或全屏交互);针对 bash、sh、zsh、shell 等系统控制台语言声明的代码块,则进一步隐去行号栅格,呈现干净专注的终端命令行体验:

bash
$ ssh netcup
Last login: Tue Aug 11 13:00:00 2026 from 113.13.73.128
Welcome to netcup-piko-g11s!
$ uptime
13:00:01 up 42 days, 3:21, 1 user, load average: 0.04, 0.02, 0.00

超长代码自动折叠

当代码块纵向篇幅超过 18 行时,组件将默认折叠收敛,仅呈现顶部前缀视窗;读者可点击工具栏的展开/折叠按钮,或直接点击底部带有平滑渐隐渐变(Mask Gradient)的遮罩区域查看完整内容:

python
def sieve_of_eratosthenes(limit):
"""埃拉托斯特尼筛法:找出所有小于 limit 的质数。"""
if limit < 2:
return []
is_prime = [True] * (limit + 1)
is_prime[0] = is_prime[1] = False
for p in range(2, int(limit ** 0.5) + 1):
if is_prime[p]:
for multiple in range(p * p, limit + 1, p):
is_prime[multiple] = False
return [i for i, is_prime in enumerate(is_prime) if is_prime[i]]
def main():
primes = sieve_of_eratosthenes(100)
print(f"100 以内的质数共 {len(primes)} 个:")
print(primes)
if __name__ == "__main__":
main()

多语言标签页

用 tabs 块把同一段逻辑的不同语言实现并排切换:

js
const greet = (name) => `你好,${name}!`;
console.log(greet("晴空"));

工具栏交互

代码块右上角常驻一套轻量化交互工具栏:

  • 行号切换:默认常开,支持灵活对照;
  • 自动换行:在单行溢出时一键软换行,保障移动端阅读无横向滚动条阻滞;
  • 区块折叠:随时展开或收拢代码片段;
  • 全屏沉浸:最大化视图以适配密集排错与深度阅读(支持按 ESC 快捷退出);
  • 一键复制代码:桌面端与相邻图标规整对齐,移动端保留标准 40px 无障碍触控热区。

行内代码

正文中引用的 行内代码 与文件路径(如 server.ts)统一遵循细边框与柔和底色规范,在光标悬停时附带主题强调色响应,确保阅读视线层次清晰。

上述功能全站开箱即用,无需编写额外组件,尽享沉浸式代码阅读体验。