本文系统梳理本站代码块集成的各项功能规范与排版细节。除代码块右上角工具栏提供的交互按键外,绝大部分增强功能均基于标准的 Markdown 写作扩展语法——日常行文无需繁复配置,在围栏代码块(Fenced Code Blocks)中声明属性即可直接生效。
文件名与标题
在代码块语言标识后紧跟 title="文件名" 参数,顶部标题栏即可显式展示具体文件名,用以替代默认的语言类型标签:
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 ...] 指令注释,即可按规范输出行内强调:
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 语言即可:
const port = 8080;const port = Number(process.env.PORT ?? 8080);终端与 macOS 视效
本站所有代码块均赋予拟物化 macOS 窗口质感,并在标题栏左上角渲染标准的红黄绿三色控制按钮(支持悬停浮现专属微图标,并可点击进行折叠或全屏交互);针对 bash、sh、zsh、shell 等系统控制台语言声明的代码块,则进一步隐去行号栅格,呈现干净专注的终端命令行体验:
$ ssh netcupLast login: Tue Aug 11 13:00:00 2026 from 113.13.73.128Welcome 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)的遮罩区域查看完整内容:
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 块把同一段逻辑的不同语言实现并排切换:
const greet = (name) => `你好,${name}!`;console.log(greet("晴空"));def greet(name: str) -> str: return f"你好,{name}!"
print(greet("晴空"))package main
import "fmt"
func greet(name string) string { return fmt.Sprintf("你好,%s!", name)}
func main() { fmt.Println(greet("晴空"))}工具栏交互
代码块右上角常驻一套轻量化交互工具栏:
- 行号切换:默认常开,支持灵活对照;
- 自动换行:在单行溢出时一键软换行,保障移动端阅读无横向滚动条阻滞;
- 区块折叠:随时展开或收拢代码片段;
- 全屏沉浸:最大化视图以适配密集排错与深度阅读(支持按
ESC快捷退出); - 一键复制代码:桌面端与相邻图标规整对齐,移动端保留标准 40px 无障碍触控热区。
行内代码
正文中引用的 行内代码 与文件路径(如 server.ts)统一遵循细边框与柔和底色规范,在光标悬停时附带主题强调色响应,确保阅读视线层次清晰。
上述功能全站开箱即用,无需编写额外组件,尽享沉浸式代码阅读体验。
评论
GitHub 登录后可评论。
评论区会在滚动到这里时自动加载。