devpack
EnglishDeutschFrançaisEspañolPortuguês (Brasil)
Auditoria do site

Gerador de Changelog — De Conventional Commits para Markdown

Cole seu git log e receba uma seção CHANGELOG.md organizada: commits agrupados em Funcionalidades, Correções de Bugs, Performance e Breaking Changes, escopos em negrito, links para os commits — além da próxima versão semântica.

Atualizado em
Obter commits desde a última tag:git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"%h %s"
Seção CHANGELOG.md



    
 Seus dados nunca saem do seu computador. Todo o processamento acontece localmente no navegador.

    
    
    

      
Como usar: Gerador de Changelog
  1. Execute o comando git log mostrado acima no seu repositório e cole a saída (hash + assunto por linha).
  2. Informe a versão atual; a versão de release é sugerida a partir dos commits — ou digite a sua.
  3. Escolha os títulos Conventional ou Keep a Changelog e adicione a URL do seu repositório para linkar os hashes dos commits.
  4. Copie o Markdown para o topo do seu CHANGELOG.md ou para uma release no GitHub.


Conventional Commits em 30 segundos


Cada assunto de commit começa com um tipo, um escopo opcional e uma descrição: feat(cart): add coupon field. Um ! após o tipo/escopo ou uma nota BREAKING CHANGE: marca uma mudança incompatível.


TipoSeçãoIncremento de versão


featFeatures / AddedMinor


fixBug Fixes / FixedPatch


perfPerformancePatch


feat!, BREAKING CHANGEBreaking ChangesMajor


refactor, docs, style, test, build, ci, choreOutros / ocultosNenhum


revertRevertsPatch




Keep a Changelog


Keep a Changelog agrupa as entradas para pessoas em Added, Changed, Deprecated, Removed, Fixed, Security, com a release mais recente primeiro e uma seção Unreleased no topo. Escolha esse estilo se seus usuários leem o changelog, e não apenas desenvolvedores.


Do changelog à release


Confira a versão sugerida com o Calculador de Versão Semântica, atualize o version no seu package.json e, em seguida, crie a tag e envie a release — o Gerador de Comandos Git tem os comandos. Um workflow do GitHub Actions pode fazer o build e publicar a cada tag.
Também pesquisado como: changelog conventional commits, keep a changelog, gerador de release notes, changelog.md, git log changelog, release notes semânticas, conventional commits.
Ferramentas que combinam com: Gerador de Changelog
  • Gerador de Conventional Commits — Escreva mensagens de commit que seguem a especificação Conventional Commits sem precisar decorá-la.
  • Gerador de README — Preencha alguns campos e receba um README.md limpo e pronto para o GitHub, com badges, instalação, exemplo de uso, tabela de configuração, variáveis de ambiente, roadmap e licença, além de preview ao vivo e checagem de completude.
  • Validador YAML — Cole um arquivo Docker Compose, manifesto Kubernetes, workflow do GitHub Actions ou qualquer YAML para localizar erros, evitar armadilhas comuns e obter uma versão bem formatada.
  • Gerador de YAML Kubernetes — Preencha o nome, a imagem e a porta do seu app e receba YAML do Kubernetes pronto para produção: um Deployment com probes, limites de recursos e contexto de segurança reforçado, além do Service, do Ingress com TLS, do ConfigMap, do Secret e do HorizontalPodAutoscaler que você marcar, tudo em um arquivo pronto para kubectl apply.
Perguntas frequentes
Qual formato de git log devo colar?
O ideal é um commit por linha, com o hash curto primeiro: git log --pretty=format:"%h %s". Assuntos simples sem hashes também funcionam. Commits de merge são ignorados automaticamente.
Como a próxima versão é calculada?
Qualquer breaking change incrementa a versão major; caso contrário, qualquer feat incrementa a minor; caso contrário, correções e melhorias de performance incrementam a patch. Nas versões 0.x, breaking changes incrementam a minor.
O que acontece com commits que não seguem o Conventional Commits?
Eles aparecem em “Outras mudanças” (estilo Conventional) ou em “Changed” (Keep a Changelog), para que nada se perca. Apague as linhas que você não quer na saída.
Posso gerar o changelog automaticamente no CI?
Sim — ferramentas como release-please, semantic-release ou changesets fazem isso a cada merge. Este gerador é útil para projetos pequenos, releases manuais ou para conferir o que essas ferramentas vão produzir.
Posso instalar o Gerador de Changelog como um aplicativo da web e usá-lo offline?
Sim. O Gerador de Changelog é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.

      
    

    
    
Ferramentas relacionadas
localGerador de Conventional CommitsEscreva mensagens de commit que seguem a especificação Conventional Commits sem precisar decorá-la.…localCalculadora SemverTudo sobre versões semânticas em um só lugar: compare duas versões, calcule o próximo…localGerador de comandos do GitEscolha uma tarefa como “desfazer o último commit, mas manter minhas alterações” ou “renomear um branch no…localGerador de READMEPreencha alguns campos e receba um README.md limpo e pronto para o GitHub, com badges, instalação, exemplo…localGerador de fluxos de trabalho do GitHub ActionsEscolha sua pilha, gatilhos e etapas e receba um arquivo .github/workflows/ci.yml — instalação, cache,…localGerador de package.jsonPreencha o formulário e receba um package.json válido — validação do nome no npm, predefinições de scripts…