jqzindie · ai
POST

最小博客架构:Next.js App Router + Markdown 的可维护组合

2026-02-09jqzdev.com

English TL;DR: The simplest maintainable blog stack is App Router + Markdown + static generation. It’s cheap, fast, and SEO‑friendly.

独立博客的核心目标是:长期可维护 + 低成本 + 可扩展。如果你不需要复杂 CMS,我推荐一个“最小但是能打”的组合:

  • Next.js App Router
  • Markdown(frontmatter + 内容)
  • 构建时静态生成(SSG)

下面是这套组合的最小结构与理由。


1) 目录结构(最小但清晰)

src/
  app/
    blog/
      [slug]/page.tsx
      page.tsx
  content/
    posts/
      hello.md
  lib/
    posts.ts

关键点:

  • 文章只存 Markdown
  • 解析逻辑集中在 lib/posts.ts
  • App Router 页面只负责渲染与 SEO

2) Markdown frontmatter 作为唯一数据源

每篇文章头部要包含:

---
title: ...
date: 2026-02-09
summary: ...
tags: [seo, nextjs]
---

好处:

  • SEO meta 可以直接生成
  • 可用于列表页筛选/排序
  • 不需要额外数据库

3) 静态生成(SSG)是博客的默认答案

原因很简单:

  • 内容更新频率低
  • 页面可缓存且稳定
  • SEO 友好 + 首屏快

App Router 中配合 generateStaticParams() 即可。


4) 你只需要 3 个能力

  • 列表页:按时间排序
  • 详情页:解析 Markdown + 渲染
  • SEOgenerateMetadata()

剩下的能力(搜索/标签/评论)都可以在有流量后再加。


5) 何时需要 CMS?

满足以下任一条件再考虑:

  • 多人协作写作
  • 需要权限与工作流
  • 内容量 > 1000 篇

否则 Markdown 足够。


相关阅读

结论: 当你只想写内容、控制成本、可维护时,这套最小架构几乎是最优解。

RELATED