Đà Nẵng, VN,--:--:--
Tất cả bài viết
  • #mdx
  • #next.js

Blog này hoạt động thế nào: viết bài với MDX

Điểm qua mọi tính năng khi viết bài trên blog này — frontmatter, code block có highlight dòng, callout, bảng và component React tuỳ chỉnh.

NDNgoc Duc2 phút đọc

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:

content/blog/vi/bai-moi.mdx
yaml
---
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
  1. Viết bài
  2. Xem trước với pnpm dev
  3. 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.

components/Counter.tsx
tsx
"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ọnVí 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ừ
css
: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:

mdx
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 ✦

Bạn có dự án nào không?

Trò chuyện nhé