Building a Block-Based Blog Detail Page

Author: Someone

Published at 2026-04-05

Why I stopped treating blocks as the source of truth

At first, a custom block renderer felt flexible. It was good for learning UI composition, but not good for authoring real posts.

When I think about the future of this project, I want writers to create articles with markdown, code fences, images, and headings without touching JSON by hand.

What markdown-first gives me

  • easier authoring
  • easier admin workflows later
  • simpler storage in a database
  • cleaner migration path to an editor or CMS

Example: a post model

export type Post = {
  id: number;
  slug: string;
  title: string;
  description: string;
  content: string;
};

Images also fit naturally

Next.js logo

The image syntax is already familiar to writers, and the renderer can later upgrade it to a richer component if needed.

markdown
architecture
frontend