让技术博客里的代码块、Callout 和图表更好读
长文中的视觉节奏、代码块样式和图表容器。
阅读节奏
技术文章不是把信息堆上去就结束。代码、图表和提示块要服务理解,而不是成为装饰。
代码块
代码块适合使用深色背景,和正文形成清晰边界。
npm run build
文件下载链接
文章可以链接到 /files/ 下的公开静态文件,例如:
[下载文件](/files/example.pdf)
文件必须先放入 public/files/ 后才可下载。public/files/ 是公开目录,不能放敏感资料。
图表
流程图和架构图应该有标题、容器和简短说明,方便读者知道图在解释哪一段逻辑。