Trình tạo changelog

Viết changelog thủ công nghĩa là phải lục tìm git log mỗi khi phát hành. Trình tạo này bỏ qua bước đó: bạn dán trực tiếp các mục muốn đưa vào đúng danh mục, Added, Changed, Fixed và Removed, thêm số phiên bản và ngày tháng, và nó tạo ra một phần Markdown theo kiểu Keep a Changelog sẵn sàng để dán vào CHANGELOG.md. Nội dung tương tự cũng có thể được tạo dưới dạng văn bản thuần. Công cụ này không đọc lịch sử git của bạn; bạn là người quyết định thay đổi nào được đưa vào bản phát hành.

Cách tạo changelog

  1. 1

    Nhập phiên bản và ngày tháng

    Gõ số phiên bản, ví dụ 1.2.0. Để trống ngày tháng để dùng ngày hôm nay.

  2. 2

    Thêm mục theo danh mục

    Dán ghi chú phát hành vào Added, Changed, Fixed và Removed, mỗi dòng một mục. Các danh mục trống sẽ được bỏ qua.

  3. 3

    Chọn định dạng xuất ra

    Markdown (tiêu đề `## [phiên bản] - ngày` với các phần kiểu `### Added`) hoặc văn bản thuần (tiêu đề `v1.2.0 (ngày)` với danh sách gạch đầu dòng).

  4. 4

    Sao chép changelog

    Dán kết quả lên phía trên mục trước đó trong CHANGELOG.md.

Bốn danh mục

Trình tạo tạo ra đúng bốn phần, theo thứ tự này: Added, Changed, Fixed và Removed. Tiêu đề phần trong kết quả giữ nguyên bằng tiếng Anh, đúng cách đặt tên chuẩn của Keep a Changelog.

Danh mục Khi nào dùng
Added Tính năng mới
Changed Thay đổi chức năng hiện có
Fixed Sửa lỗi
Removed Tính năng đã bị loại bỏ

Quy ước Keep a Changelog cũng có các phần Deprecated, Security và Breaking. Trình tạo không có ô cho các phần này; bạn có thể tự thêm các phần đó sau khi dán kết quả.

Ví dụ kết quả (Markdown)

## [1.4.0] - 2026-04-18

### Added
- Dark mode support for the dashboard (#312)
- CSV export on the users page (#318)

### Changed
- Upgrade React to 18.3 (#320)
- Pagination now defaults to 50 items per page (#322)

### Fixed
- Crash when editing users with a null email (#319)
- Timezone offset in scheduled reports (#321)

### Removed
- Legacy reports API (#324)

Ví dụ kết quả (văn bản thuần)

v1.4.0 (2026-04-18)
ADDED:
  • Dark mode support for the dashboard (#312)
  • CSV export on the users page (#318)
CHANGED:
  • Upgrade React to 18.3 (#320)
  • Pagination now defaults to 50 items per page (#322)
FIXED:
  • Crash when editing users with a null email (#319)
  • Timezone offset in scheduled reports (#321)
REMOVED:
  • Legacy reports API (#324)

Mẹo

  • Mỗi dòng một mục. Mỗi dòng trong một ô sẽ trở thành một dấu đầu dòng. Các ô trống được bỏ qua và bạn có thể để trống cả một danh mục.
  • Viết các mục như các dòng của changelog, không phải ghi chú nhật ký. Thể mệnh lệnh “fix: handle null email on edit” đọc rất ổn như một dấu đầu dòng.
  • Tham chiếu số issue/PR để người đọc có thể tìm hiểu sâu hơn: (#319) hoặc [#319](link) trong kết quả.
  • Một phiên bản cho mỗi mục: đừng gộp hai bản phát hành vào một khối, dù chỉ cách nhau một ngày.
  • Đã phát hành hay chưa: giữ phần [Chưa phát hành] ở đầu trang với các thay đổi dành cho phiên bản tiếp theo, rồi chuyển chúng sang phần có ngày tháng khi phát hành.

Câu hỏi thường gặp

Quy ước Keep a Changelog (keepachangelog.com): tiêu đề phiên bản kèm ngày tháng và các danh sách gạch đầu dòng được nhóm lại. Trình tạo tạo ra các phần Added, Changed, Fixed và Removed; các phần chuẩn khác (Deprecated, Security, Breaking) cũng tuân theo quy ước này nếu bạn tự thêm chúng.

Trình tạo tạo ra bốn phần chính: Added, Changed, Fixed và Removed. Không có ô riêng cho Deprecated, Security hoặc Breaking, nhưng bạn có thể tự thêm các phần này vào văn bản đã tạo trước khi dán.

Trình tạo là công cụ giao diện dùng một lần; để tự động hóa, hãy dùng CLI như standard-version, release-please hoặc semantic-release, những công cụ triển khai cùng mẫu thiết kế trong đường dẫn build của bạn.

Không. Công cụ không đọc kho lưu trữ hay thông điệp commit của bạn; bạn tự dán các mục vào. Văn bản bạn gõ được gửi đến máy chủ để tạo kết quả và không được lưu trữ hay chia sẻ.

Công cụ liên quan