How to draft release notes from commit subjects in Obsidian

As of October 2026, the Obsidian core plugin list describes no commit subject grouper. You can group subjects in a Markdown note yourself or use Conventional Commit Draft. Check commit bodies separately for breaking change details.

Background

The Conventional Commits specification gives feature and fix types distinct meanings. It permits breaking changes in a footer or subject marker. A subject list can miss information that exists only in a body.

3 ways to do it

  1. Group the subjects by hand

    Create a Markdown note with headings for features and fixes. Place subjects under the matching headings, then read the original changes before you describe compatibility effects.

    limits
    You must check types and group the subjects yourself. Keep body details beside the draft if they affect the release.
  2. Generate notes in GitHub

    For a GitHub repository, the release form can generate notes from merged pull requests. A configuration file can group pull requests by labels and exclude selected labels or authors.

    limits
    This method uses repository pull requests. It does not group an arbitrary selection from your Obsidian note.
  3. Conventional Commit Draft from this site

    Select subjects in an editable note and run Preview release draft from selection. The preview groups recognized types and keeps uncertain lines under Review. Save a separate note after you check the text.

    limits
    Input stops at 2,000 nonblank lines. Saved headings and named templates need Pro, and commit bodies do not supply breaking labels.
    The draft preview keeps an unknown type and two Review lines visible.
    Open larger

    MIT · no telemetry · core features free

    All features of Conventional Commit Draft

Create a local release draft

  1. Open a Markdown note in an editable view and select one commit subject per line.

  2. Run Preview release draft from selection from the command palette.

  3. Check the groups, scopes, BREAKING labels and Review lines.

  4. Set a release title and project name, then select Save new draft.

  5. Open the new note from the file explorer.

Common questions

Does a subject list prove which version to release?

No. The specification relates types and breaking changes to version changes. Check the changes and body details before choosing a version.

How can I keep a project type visible?

The free draft places a parsed project type under Other with its type name. Pro lets you give that type a saved heading. Lines that do not parse stay under Review.

Photo of Michael LipThat's every step, start to finish.

Obsidian rewards people who share. NoteMods is just me and a lot of coffee. If this guide saved you a fight with the syntax, buy me a cup.