Changelog 生成器Keep a Changelog

填好版本号与日期,逐条录入 新增 / 修复 / 变更 内容,即刻生成符合规范的 Markdown 版本更新日志,可复制、可下载为 CHANGELOG.md,全程本地生成。

本次发版信息

添加条目

    生成结果(Markdown)

    模板预设(9 个常用发版场景)

    点一下即填入版本号、日期与成组条目,套用后仍可自由增删;日期默认取今天。

    多格式导出

    同一份条目可导出为 Markdown、纯文本、JSON 与静态 HTML,按发版渠道取用。

    先添加条目后自动生成

    方案管理 · 数值对比 · 导出

    调好的参数可存成方案随时载入,也能生成可分享链接;结果里的数值列会自动画成对比图,并支持导出 CSV / JSON。

    最近方案 暂无

    📝口径说明与常见误填

    按 Keep a Changelog 口径整理,发版归档更稳妥。

    语义化版本
    x.y.z 三段对应主版本.次版本.修订号:不兼容改动升主版本、向后兼容加功能升次版本、仅修 Bug 升修订号,版本号非法时本页会提示。
    Unreleased 段
    尚未发版的改动先记在 Unreleased 标题下,发版当天再改写成「版本号 + 日期」的正式段落。
    六种条目类型
    Added / Changed / Deprecated / Removed / Fixed / Security 是 Keep a Changelog 的标准分组,本页按此顺序自动归类排序。
    日期口径
    版本行日期用 ISO 8601(如 2026-11-02),发版日期以公开可见的那天为准,不要填内部合码日。
    常见误区
    直接粘贴 git log 原始输出不是 changelog:读者要的是「改了什么、影响谁」,commit 号最多作补充。

    这个工具解决什么问题

    每次发版手写更新日志最费神:格式记不全、条目漏归类、版本号还可能写错。本工具按 Keep a Changelog 规范把版本号、日期与逐条改动整理成标准 Markdown——自动校验语义化版本、按六种类型分组排序,一键复制或下载 CHANGELOG.md,全程浏览器本地生成,不上传任何代码与版本信息。

    三条写日志铁律

    ① 面向用户写,不面向 commit:每条说清「改了什么、对谁有影响」,内部重构这类用户无感的事可以合并或不写。

    ② 发版前先攒 Unreleased:平时把改动逐条记进 Unreleased 段,发版时只改标题行,避免临发版翻提交记录补作业。

    ③ 版本号一次定对:破坏性变更必须升主版本;本页对不符合 x.y.z 的版本号会当场标红提醒,别带着非法版本号发出去。

    怎么用

    1. 第 1 步 · 填写版本号与日期
      在「本次发版信息」输入语义化版本号(如 1.4.2)与发版日期,日期默认今天,可手动改。
    2. 第 2 步 · 逐条添加改动条目
      选择 Added / Changed / Fixed 等类型,写一条内容点「+ 添加」;列表可逐条删除,支持回车快捷添加。
    3. 第 3 步 · 核对生成的 Markdown
      右侧结果区实时输出规范格式:版本行、类型分组、条目顺序都已排好,不符合规范的版本号会有红色提示。
    4. 第 4 步 · 复制或下载文件
      点「复制结果」进剪贴板,或「下载 CHANGELOG.md」直接提交进仓库;「载入示例」可先看完整模板长什么样。

    更新记录

    • v1.0 2026-11-02
    • 2026-11-02 上线首个版本
    • 2026-11-02 完善结果展示

    常见问题

    changelog 怎么写?
    按「版本号 + 日期」分节,节内按 Added / Changed / Fixed 等类型列条目,一条一行、动词开头写清楚「改了什么、影响谁」。本页会自动按规范排版生成。
    版本更新日志模板 markdown 有现成的吗?
    有。点击「载入示例」即可得到一份含 Unreleased 段与语义化版本的完整 Markdown 模板,改条目复制即用。
    keep a changelog 格式是什么?
    是社区通行的更新日志规范:标题固定为 # Changelog,版本行写成 ## [1.2.0] - 2026-11-02,条目按六种类型分组,并声明遵循语义化版本(SemVer)。
    有软件更新日志生成工具吗?
    本工具即是:浏览器本地生成,不上传任何代码与版本信息,支持复制与下载 CHANGELOG.md 文件,适合发版前快速整理。
    能用 git 提交记录生成 changelog 吗?
    可以:先用 git log --oneline 导出提交列表,把要点逐条录入本页并归类到 Added/Fixed 等类型,即可整理成规范日志;比直接粘贴 commit 记录更易读。

    💬 留言板 0

    全部留言需审核通过后展示
    💬

    还没有留言,来抢沙发吧!

    ✍️ 说点什么
    0 / 500
    图形验证码
    👣 做完这一步,顺便看看
    🏛️ 凯撒密码解密 凯撒密码解密 :1~25 位位移加解密、ROT13 一键转换… → 🔤 乱码转换器在线修复 乱码转换器在线 :把“锟斤拷”“�”“涓枃”“😀”等乱… → 📸 代码截图美化工具 在线代码转图片工具:粘贴或输入代码(支持 JavaScrip… → 🎨 WCAG 对比度检测工具 在线颜色对比度检测工具:输入前景文字色与背景色(支持 #he… →
    全部工具 →