← Back to blog

内容系统与标签策略:让 Blog 和 Notes 各司其职

· 2 min read

内容系统分成两条线:blog 用来承载完整文章,notes 用来记录短小但有价值的维护片段。两者都进入搜索索引,但语气和结构不同。

Blog 的职责

Blog 应该回答一个完整问题。文章可以包含上下文、取舍、实现细节和维护建议。

这些内容会出现在博客列表、详情页、RSS 和 OG 图片中,所以 frontmatter 的 descriptiontags 要写得清楚。

Notes 的职责

Notes 更像项目维护日志。它可以记录一个 bug 的原因、一个约定的边界、一次配置变更,或者一个常用命令背后的注意点。

笔记不需要长篇铺陈,但要给未来的维护者留下足够线索:发生了什么、为什么这样处理、下次遇到时看哪里。

标签覆盖

标签不只是装饰,它会影响归档扫描和搜索召回。这个项目建议覆盖以下几类:

  • 技术栈:astroreacttailwindtypescript
  • 架构边界:architectureislandsbrowser-init
  • 内容维护:contentmarkdowntagssearch
  • 视觉与生成:design-systemog-imagesvgautomation
  • 质量保障:testingtypecheckworkflow

当一篇内容横跨多个领域时,优先选择最能帮助检索的标签,而不是把所有相关词都塞进去。

contenttagssearchastromarkdown