MDX 内容管线
用 MDX 保存内容,用统一加载层把文件转换为页面可消费的数据结构。
MDX内容管理Next.js
适用场景
MDX 适合内容量不大、需要版本控制、又希望在正文中保留 Markdown 和组件能力的个人站点。博客、知识库和项目页都可以使用同一套文件约定。
文件约定
每篇内容对应一个 .mdx 文件。frontmatter 保存标题、日期、标签、摘要、阅读时间、分类和关联项目;正文由页面渲染。
这样内容作者只维护文件,页面组件不直接关心文件格式细节。
加载层的职责
content-loader 读取 MDX、校验 frontmatter、生成 slug 和 URL,并返回统一的数据类型。页面只消费加载层的结果,不直接读取目录或解析文件。
这条边界有两个好处:一是页面逻辑更简单;二是以后改为 CMS、数据库或 API 时,可以优先替换加载层内部实现,而不是同时修改所有页面。
维护边界
内容类型的差别通过目录和 frontmatter 表达:博客用于记录,知识库用于技术沉淀,项目页用于完整项目说明。关联项目和内部链接负责把它们串起来,不在每篇正文中重复同一段背景。
相关内容:LiuliX Glaze 项目页。