视觉实验室

让技术博客里的代码块、Callout 和图表更好读

长文中的视觉节奏、代码块样式和图表容器。

作者:黄撑 更新于 2026-06-08

阅读节奏

技术文章不是把信息堆上去就结束。代码、图表和提示块要服务理解,而不是成为装饰。

代码块

代码块适合使用深色背景,和正文形成清晰边界。

npm run build

文件下载链接

文章可以链接到 /files/ 下的公开静态文件,例如:

[下载文件](/files/example.pdf)

文件必须先放入 public/files/ 后才可下载。public/files/ 是公开目录,不能放敏感资料。

图表

流程图和架构图应该有标题、容器和简短说明,方便读者知道图在解释哪一段逻辑。