以 Markdown 为核心的内容架构实践
本官网如何用 Nuxt Content 构建「文件即数据」的内容层:schema 校验、草稿机制与后台直写。

企业官网的内容管理常年在两种方案间摇摆:重型 CMS 功能全但部署重,静态页面轻但改内容要发版。本官网的做法是第三条路——以 Markdown 文件为唯一内容源,用 Nuxt Content v3 提供查询与渲染,用自研轻量后台提供可视化编辑。
Schema 即契约。 所有 frontmatter 由 zod schema 严格校验:新闻的 tag、案例的行业与服务线均限定在受控词表内,杜绝自由文本带来的脏数据。一条缺少 title 的内容在查询阶段即报可读错误,而不是渲染出残缺页面。
草稿即文件字段。 draft: true 的条目在所有前台查询中被统一过滤,作者可以随时发布或撤下内容——本质只是改一个字段、提交一次。
后台直写文件。 编辑器保存时按固定字段顺序重写 Markdown,git 历史即内容审计日志。对中小团队而言,这比引入数据库与独立 CMS 更可维护。
这套架构的适用边界也很清晰:内容量在千条以内、协作角色简单、追求部署轻量。如果你的场景符合,欢迎参考;如果需要重内容工作流,我们也在为客户构建更完整的方案。