Skip to main content
Git & GitHub Tools

Changelog Generator

Turn a list of changes into a structured, Markdown-formatted CHANGELOG entry.

Add your changes under the relevant category - Added, Changed, Deprecated, Removed, Fixed, or Security - and this tool formats a clean Markdown changelog entry.

Following a consistent changelog format like this makes it much easier for users to scan what changed between versions.

What Is a Changelog?

A changelog is a file (conventionally CHANGELOG.md) that documents notable changes for each release of a project, typically grouped into categories like Added, Changed, Deprecated, Removed, Fixed, and Security - a format popularized by the "Keep a Changelog" convention.

Why Use This Tool?

Formatting a changelog entry consistently by hand is tedious - this tool takes your list of changes per category and produces properly structured Markdown with the right heading levels and bullet formatting every time.

How to Use It

  1. Enter a version number and date for the release.
  2. Add one or more change entries under each relevant category (Added, Changed, Deprecated, Removed, Fixed, Security) - leave a category empty to omit it.
  3. Copy the generated Markdown into your CHANGELOG.md file.

Limitations

This formats the entries you provide - it does not automatically detect what changed in your code or commits. For that, keeping consistent Conventional Commit messages (see the Git Commit Message Generator) makes writing changelog entries easier.

Frequently Asked Questions

The widely used Keep a Changelog format groups changes under Added, Changed, Deprecated, Removed, Fixed and Security, with the version number and release date as the heading.

Yes. Put the latest release first so readers see recent changes immediately.

No. A changelog is written for users and summarises notable changes. A Git log lists every commit, including internal ones users do not care about.
Share this tool: