最近有作者反馈配图显示不出来,这里统一说明,顺便给几条排版建议。
图片为什么会挂
本站的内容安全策略(CSP)对图片来源有限制,只允许本站、data 与 blob、腾讯云 COS、QQ 头像、GitHub 头像、Gitee、DiceBear 等来源。除此之外的图床,浏览器会直接拦截,表现为图片位置空白或显示裂图图标。
另外,Markdown 渲染器会剥离 data URI。所以「把图片转成 base64 内嵌」这条路也走不通。
可行的做法
一是把图片上传到站内附件,走本站域名。二是在正文里用 DiceBear 的直链生成占位头像类插图(api.dicebear.com 的 png 接口,带 seed 参数),这类链接在允许列表内。
不要用 picsum、unsplash、wikimedia 这类公共图床,全部会被拦。
排版几条建议
标题控制在 55 字以内。太长的标题在列表页会被截断,读者看不到关键信息。
小标题用加粗而不是多级标题。技术贴在列表页和详情页都会渲染,层级太深反而乱。
代码块标好语言。不标语言时高亮器会猜,猜错的配色比不高亮更难看。
数字与单位之间留空格,比如 128 GB、0.35 秒。这一个小习惯能让整篇看起来专业很多。
关于链接
外链尽量给原始来源,别给聚合站的转载页。转载页经常改标题、删上下文,读者点进去找不到对应内容。
失效链接可以在评论区补充,版主会更新正文。
一个提醒
贴长日志时,只贴关键片段,用省略号标注截断位置。整篇几千行日志贴上来,读者会直接跳过,你想要的帮助也就没了。
最后
配图是为了说明问题,不是为了好看。一张架构图、一张报错截图、一张对比表,比十张装饰图有用。
本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。