Mỗi bài viết ở đây là một file .mdx trong content/blog/<ngôn ngữ>/. Tên file chính là URL, nên bài này nằm ở content/blog/vi/writing-with-mdx.mdx → /vi/blog/writing-with-mdx. Thêm một file mới vào thư mục, build lại, và bài sẽ xuất hiện ở trang blog, trang chủ và trong link bài trước/bài sau.
Song ngữ
Bản tiếng Anh nằm ở content/blog/en/, bản tiếng Việt ở content/blog/vi/, cùng tên file. Nếu một bài chưa có bản tiếng Việt, trang /vi sẽ hiển thị bản tiếng Anh kèm nhãn EN và một dòng thông báo — nên bạn có thể dịch dần.
Frontmatter
Mỗi file bắt đầu bằng một khối YAML. Chỉ title và date là thực sự bắt buộc:
---
title: "Bài viết mới của tôi"
description: "Một câu mô tả, hiện ở danh sách và khi chia sẻ link."
date: "2026-11-21"
tags: ["react", "css"]
draft: true # ẩn bài cho đến khi viết xong
---Bài được sắp xếp theo date (mới nhất trước). Thời gian đọc và mục lục "Trong bài này" được tạo tự động từ nội dung.
Markdown quen thuộc
In đậm, in nghiêng, gạch ngang, liên kết và code inline đều dùng được. Danh sách cũng vậy:
- Markdown kiểu GitHub qua
remark-gfm - Link neo cho tiêu đề qua
rehype-slug— rê chuột vào tiêu đề và bấm# - Tô màu cú pháp qua
rehype-pretty-code+ Shiki
- Viết bài
- Xem trước với
pnpm dev - Xuất bản
Viết hay là viết lại — và code tốt phần lớn là xoá bớt.
Code block
Code được tô màu ngay lúc build, nên người đọc không phải tải thêm JavaScript. Màu tự đổi theo giao diện sáng/tối và có nút sao chép.
"use client";
import { useState } from "react";
export function Counter() {
const [count, setCount] = useState(0);
return (
<button onClick={() => setCount((c) => c + 1)}>
Đã bấm {count} lần
</button>
);
}Block trên dùng ba tuỳ chọn đặt sau tên ngôn ngữ:
| Tuỳ chọn | Ví dụ | Tác dụng |
|---|---|---|
title="…" | title="app.tsx" | Thêm tiêu đề tên file |
{lines} | {4,8-10} | Highlight các dòng |
showLineNumbers | — | Hiện số dòng |
/word/ | /useState/ | Highlight một từ |
:root {
--primary: #34a0a4;
}Callout
Vì là MDX, bạn có thể dùng component React ngay trong bài. Callout có sẵn ở mọi bài — không cần import:
Component của riêng bạn
Cần thứ gì đó tương tác cho riêng một bài? Import ở đầu file .mdx như mọi component React:
import { Chart } from "@/app/components/blog/Chart";
Dữ liệu đây:
<Chart data={[1, 3, 2, 5]} />Server component được render thành HTML lúc build. Chỉ thêm "use client" khi component cần state hoặc API của trình duyệt.
Vậy là xong. Chúc bạn viết vui ✦