blog.post
Hello MDX — Blog System Launch
How this site's MDX blog workflow works: writing, publishing, and extending.
June 20, 20261 min read
Next.jsMDXBlog
This blog is written in MDX: the simplicity of Markdown plus the flexibility of React components.
Why MDX?
- Write like Markdown — easy to pick up
- Embed custom components when needed (callouts, charts, etc.)
- Works with the Next.js App Router for static generation and SEO
New posts live in content/blog/{locale}/. The filename is the URL slug. For example hello-mdx.mdx → /blog/hello-mdx (or /en/blog/hello-mdx in English).
Publishing workflow
- Create a new
.mdxfile undercontent/blog/en/(orzh/) - Fill in frontmatter (
title,description,date,tags) - Write the body — code blocks and custom components are supported
- Preview with
npm run dev; the build adds posts to the sitemap automatically
npm run dev
# Open http://localhost:3000/en/blog
Frontmatter template
title: "Post title"
description: "One-line summary for SEO and list cards"
date: "2026-06-20"
tags: ["tag1", "tag2"]
published: true
Set published to false to hide a draft without deleting it.
Next up: a technical recap of the RAG knowledge base project. Reach out via the contact section if you have ideas to share.