954 字
3 分钟
Jekyll 博客内容质量清单：发布前 15 分钟自检模板
技术博客最常见的问题不是不会写，而是“写完就发，发完就沉底”。 要让文章长期带来搜索流量、读者收藏和广告价值，你需要一套发布前自检流程。
这篇文章给你一份可以直接照抄的 15 分钟检查清单，适用于 Jekyll 站点。
1. 文章结构检查（3 分钟）
先确认内容是否具备“可执行”结构，而不是流水账。
最低结构建议：
- 问题定义：这篇文解决什么场景
- 前置条件：环境、版本、依赖
- 分步过程：每一步都能复现
- 排错章节：至少 3 个常见报错
- 总结：适用边界和下一步建议
如果缺少其中 2 项以上，这篇文章通常还不够成熟。
2. 信息密度检查（2 分钟）
快速判断“有没有干货”：
- 是否包含可复制命令
- 是否说明参数为什么这么配
- 是否覆盖失败分支（不是只写 happy path）
- 是否给出明确版本信息
判断标准：读者不需要“猜你在说什么”。
3. SEO 基础检查（3 分钟）
Jekyll 文章发布前，至少核对这几项：
title是否清晰表达主题和人群subtitle是否补足上下文tags是否与正文一致（避免乱打标签）- 首段是否在 80-120 字内讲清价值
- 是否有至少 2 个二级标题（
##）
如果你的站点有站内搜索，标题和首段决定了点击率上限。
4. 可信度检查（2 分钟）
技术文要建立可信度，至少做到：
- 标注命令适用系统（macOS/Linux/Windows）
- 标注版本（如 Node 20、Python 3.12）
- 对高风险操作加警告
- 对引用资料注明来源（官方文档优先）
可信度越高，读者停留时间和回访率越高。
5. 合规检查（2 分钟）
如果你依赖广告变现，这一步不能省。
- 是否含有误导性标题
- 是否包含潜在违规导向（攻击、绕过、侵权）
- 是否出现“结论性断言但无依据”
- 是否存在明显采集痕迹
不确定的段落，宁可删掉，也不要赌审核。
6. Jekyll 站点级检查（2 分钟）
发布后快速检查：
- 页面能否正常渲染
- 内链是否可点击
- 图片路径是否正确
- 文章是否进入归档页
feed.xml是否更新
你可以在本地先跑：
bundle exec jekyll serve然后手动点开文章，检查移动端布局和代码高亮。
7. 一份可复制的发布前模板
你可以把下面这段直接放进你的草稿顶部：
[发布前检查]- [ ] 标题是否准确且不夸张- [ ] 首段是否说清目标读者与收益- [ ] 是否有前置条件与版本信息- [ ] 是否有可复制命令与示例- [ ] 是否有常见错误与排查- [ ] 是否标注风险操作- [ ] 是否完成内链和图片检查- [ ] 是否通过移动端阅读检查- [ ] 是否通过合规检查当你连续执行 20 篇后，文章质量会显著稳定。
8. 建议的周节奏
如果你是个人站长，可用这个节奏：
- 周一：选题与资料整理
- 周三：写正文与代码示例
- 周五：自检 + 发布
- 周末：回看数据（搜索曝光、停留时长、跳出）
不要把“发布”当终点，数据复盘才是内容升级的开始。
总结
高质量内容不是灵感驱动，而是流程驱动。
你只要把发布前自检流程固定下来，哪怕每周只发 1 篇，长期效果也会好过“高频低质”的更新方式。
延伸阅读
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
Jekyll 博客内容质量清单：发布前 15 分钟自检模板
https://levifree.dpdns.org/posts/jekyll-content-quality-checklist/ 部分信息可能已经过时
相关文章 智能推荐
1
Jekyll SEO 技术优化清单：从可抓取到可排名的实战配置
Jekyll Sitemap、结构化数据、Canonical 与内容聚合页，给个人博客一套可执行的 SEO 基线
2
技术博客内容集群怎么做：用现有文章建立读者能走通的阅读路径
内容运营 以主题地图、操作文与排错文建立内链；用可观察指标判断内容集群是否真的帮助读者
3
Jekyll 构建报错排查手册：10 个最常见错误与修复步骤
Jekyll 从 Front Matter、依赖冲突到端口占用，给博客维护者一份可复制的故障处理流程
4
GitHub Actions 实战：为 Jekyll 博客搭建自动化质量检查流水线
GitHub Actions 每次提交自动检查 Markdown、死链与构建状态，减少线上翻车
5
Astro 本地预览验收清单：发布前用 15 分钟发现导航、资源与交互问题
Astro 一份适用于静态博客的小型回归流程，覆盖构建诊断、关键入口、动态筛选和资源加载