변경 로그 생성기

변경 로그를 손으로 작성하려면 릴리스 시점마다 git log를 일일이 훑어야 합니다. 이 생성기는 그 단계를 건너뜁니다. 게시하려는 항목을 Added, Changed, Fixed, Removed 중 올바른 카테고리에 직접 붙여 넣고 버전 번호와 날짜를 입력하면, CHANGELOG.md에 바로 넣을 수 있는 Keep a Changelog 스타일의 마크다운 섹션이 만들어집니다. 같은 내용을 일반 텍스트로도 만들 수 있습니다. 이 도구는 git 기록을 읽지 않으며, 어떤 변경 사항을 릴리스에 담을지는 사용자가 정합니다.

변경 로그 생성 방법

  1. 1

    버전과 날짜 입력

    버전 번호를 입력하세요(예: 1.2.0). 날짜를 비워 두면 오늘 날짜가 사용됩니다.

  2. 2

    카테고리별로 항목 추가

    릴리스 노트를 Added, Changed, Fixed, Removed 아래에 붙여 넣되 한 줄에 항목 하나씩 넣으세요. 빈 카테고리는 건너뜁니다.

  3. 3

    출력 형식 선택

    Markdown(`## [버전] - 날짜` 헤더와 `### Added` 스타일 섹션) 또는 일반 텍스트(`v1.2.0 (날짜)` 헤더와 글머리표 목록) 중에서 고릅니다.

  4. 4

    변경 로그 복사

    출력 결과를 CHANGELOG.md의 이전 항목 위에 붙여 넣으세요.

네 가지 카테고리

생성기는 Added, Changed, Fixed, Removed의 네 섹션만 이 순서대로 출력합니다.

카테고리 사용 시점
Added 새로운 기능
Changed 기존 기능의 변경 사항
Fixed 버그 수정
Removed 제거된 기능

Keep a Changelog 규약에는 Deprecated, Security, Breaking 섹션도 있습니다. 생성기에는 이에 해당하는 입력란이 없으므로, 출력을 붙여 넣은 뒤 해당 섹션을 직접 추가하면 됩니다.

출력 예시 (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)

출력 예시 (일반 텍스트)

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)

  • 한 줄에 항목 하나. 각 입력란의 줄 하나가 글머리표 하나가 됩니다. 빈 입력란은 건너뛰며, 카테고리 전체를 비워 둘 수도 있습니다.
  • 항목은 변경 로그 줄로 작성하되 로그 메모처럼 쓰지 마세요. 명령형 “fix: handle null email on edit”은 글머리표로 잘 어울립니다.
  • 이슈/PR 번호를 참조하면 독자가 더 자세히 볼 수 있습니다: 출력에서 (#319) 또는 [#319](link) 형식으로.
  • 항목당 버전 하나: 하루 차이더라도 두 릴리스를 한 블록에 합치지 마세요.
  • 릴리스 vs 미출시: 다음 버전에 담을 변경 사항은 상단에 [Unreleased] 섹션으로 유지하고, 릴리스 시점에 날짜가 있는 섹션으로 옮기세요.

자주 묻는 질문

Keep a Changelog(keepachangelog.com) 규약, 즉 날짜가 포함된 버전 헤더와 그룹화된 글머리표 목록을 따릅니다. 생성기는 Added, Changed, Fixed, Removed 섹션을 출력하며, 나머지 표준 섹션(Deprecated, Security, Breaking)도 직접 추가하면 같은 규약을 따릅니다.

생성기는 Added, Changed, Fixed, Removed의 네 가지 섹션만 출력합니다. Deprecated, Security, Breaking 전용 입력란은 없지만, 붙여 넣기 전에 생성된 텍스트에 해당 섹션을 직접 추가할 수 있습니다.

이 생성기는 일회성 UI 도구입니다. 자동화가 필요하면 빌드 파이프라인에서 같은 패턴을 구현하는 standard-version, release-please 또는 semantic-release 같은 CLI를 사용하세요.

아니요. 저장소나 커밋 메시지를 읽지 않습니다. 항목은 직접 붙여 넣는 것이며, 입력한 텍스트는 출력을 만들기 위해 서버로 전송될 뿐 저장되거나 공유되지 않습니다.

관련 도구