CHANGELOG 포맷터

브라우저 처리

버전별로 적은 변경 메모를 Keep a Changelog 형식(## [1.2.0] - 날짜, ### Added·Fixed·Removed)으로 정리합니다. 'added'·'수정' 같은 첫 단어로 항목을 분류합니다.

사용 전 확인

파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.

도구 실행입력 후 결과 확인

CHANGELOG 포맷터 샘플 실행

버전마다 대충 적어 둔 변경 메모를 CHANGELOG.md로 정리하려면 버전 제목과 분류를 맞추는 손이 많이 갑니다. 이 포맷터는 'v1.2.0' 같은 버전 줄과 그 아래 메모를 읽어 Keep a Changelog 형식으로 다시 써 줍니다.

브라우저 처리

샘플 입력

v1.2.0 (2026-09-01)
added search
fixed sitemap
removed old API

v1.1.0
initial release

샘플 결과

# Changelog

## [1.2.0] - 2026-09-01

### Added
- added search

### Fixed
- fixed sitemap

### Removed
- removed old API

## [1.1.0]

### Added
- initial release

자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

CHANGELOG 포맷터 사용 가이드

v1.2.0, 1.2.0, ## [1.2.0] 같은 줄을 버전 제목으로 보고, 뒤에 (2026-09-01)이나 - 2026-09-01이 있으면 날짜로 붙입니다. 메모는 첫 단어로 분류해 added·add·new·추가는 Added, fixed·fix·bug·수정은 Fixed, removed·delete·삭제는 Removed, docs·문서는 Documentation, 그 밖은 Changed에 넣습니다. feat:·fix: 같은 커밋 접두어도 알아봅니다.

버전 줄보다 앞에 적은 메모는 [Unreleased]에 들어가며, 절 제목은 도구들이 읽을 수 있도록 영어 표준 이름을 씁니다.

사용 방법

'버전별 변경 메모' 칸에 버전 줄과 그 아래 변경 메모를 한 줄씩 적습니다.
'실행'을 누르면 버전마다 분류된 CHANGELOG가 나옵니다.
분류가 어색한 항목만 손본 뒤 '다운로드'해 CHANGELOG.md로 저장합니다.

예시: 날짜가 붙은 버전 두 개

입력

v1.2.0 (2026-09-01)
added search
fixed sitemap
removed old API

v1.1.0
initial release

결과

# Changelog

## [1.2.0] - 2026-09-01

### Added
- added search

### Fixed
- fixed sitemap

### Removed
- removed old API

## [1.1.0]

### Added
- initial release

'initial release'는 첫 출시로 보고 Added에 넣었습니다. 메모 문장은 바꾸지 않습니다.

이럴 때 쓰면 좋아요

흩어진 버전 메모를 CHANGELOG.md 한 파일로 정리할 때
오래된 변경 기록을 Keep a Changelog 형식으로 바꿀 때
릴리스마다 분류가 들쭉날쭉한 기록을 통일할 때
패키지 배포 전에 변경 이력을 깔끔하게 보여 줄 때

문제가 생겼을 때

버전 줄이 항목으로 들어감

버전 줄은 'v1.2.0'이나 '1.2.0'만 단독으로 있거나 뒤에 날짜만 있어야 합니다. 'v1.2.0 출시'처럼 다른 글자가 붙으면 항목으로 읽습니다.

대부분 Changed로 분류됨

첫 단어로 분류하므로 '검색 기능 추가'처럼 동사가 뒤에 오는 메모는 Changed가 됩니다. '추가: 검색 기능'이나 'added search'처럼 분류어를 앞에 적으세요.

활용 팁

Keep a Changelog는 최신 버전을 맨 위에 둡니다. 메모도 최신 버전부터 적으면 결과 순서가 그대로 맞습니다.
커밋 메시지가 Conventional Commits 형식이라면 커밋 목록 → CHANGELOG 생성기를 쓰는 편이 더 정확합니다.

자주 묻는 질문

Security나 Deprecated 분류도 되나요?

아니요. Added, Fixed, Changed, Removed, Documentation과 호환성 주의 항목만 만듭니다. 보안 항목은 결과에서 ### Security 절로 옮기세요.

이미 '# Changelog' 제목이 있으면요?

입력의 '# Changelog' 줄과 ### 분류 제목은 무시하고 다시 정리하므로 기존 파일을 통째로 넣어도 됩니다.

절 제목을 한국어로 바꿀 수 있나요?

CHANGELOG는 도구 호환을 위해 영어 표준 이름을 씁니다. 사용자에게 보여 줄 한국어 문서는 릴리스 노트 생성기를 쓰세요.