Double newline at end of changelog

[davidolrik]

Not sure if it is a bug, or just me that haven't found the correct combination of newline settings.

My CHANGELOG.md, always ends up with "\n\n" at the end of the file which I want to avoid as it triggers the markdown linter MD012.

As a workaround I just added this to the end of my Changie config:

replacements:
  - path: CHANGELOG.md
    find: "\n\n$"
    replace: "\n"

This does the trick, but should probably be the default behaviour.

[miniscruff]

hm, I bet its a combination of a newline config having like +1 at the end of the version and the version itself having a newline at the end? Can I see the rest of your config?

[davidolrik]

Sure here you go:

changesDir: .changes
unreleasedDir: unreleased
headerPath: header.tpl.md
changelogPath: CHANGELOG.md
versionExt: md
versionFormat: '## {{.Version}} - {{.Time.Format "2006-01-02"}}'
kindFormat: '### {{.Kind}}'
changeFormat: '- {{.Body}}'
kinds:
    - label: Added
      auto: minor
    - label: Changed
      auto: minor
    - label: Deprecated
      auto: minor
    - label: Removed
      auto: major
    - label: Fixed
      auto: patch
    - label: Security
      auto: patch
    - label: Build
      auto: patch
newlines:
    afterChangelogHeader: 1
    afterChangelogVersion: 1
    beforeKind: 1
    afterKind: 1
envPrefix: CHANGIE_
replacements:
  - path: CHANGELOG.md
    find: "\n\n$"
    replace: "\n"

[miniscruff]

I am not able to reproduce this with your config. I would check your oldest release notes and to see if it already contains a newline. Your afterChangelogVersion config will add one after each version, including your last one.

[davidolrik]

I am not able to reproduce this with your config.

My bad - My current config was missing a afterChange: 1 that adds a new line at the end of each change fragment, making the v<version>.md pass the linter as well.

newlines:
    afterChangelogHeader: 1
    afterChangelogVersion: 1
    beforeKind: 1
    afterKind: 1
    afterChange: 1

This gives me fragments like this, with a single newline at the end:

## v0.86.0 - 2025-09-09

### Added

- Test

But 2 newlines at the end when they are merged.

Regarding afterChangelogVersion: 1, if I don't have that all my fragments will be squished together during merge.

With afterChangelogVersion: 1:

## v0.86.0 - 2025-09-09

### Added

- Test A

## v0.85.4 - 2025-09-09

### Build

- Test B

With afterChangelogVersion: 0:

## v0.86.0 - 2025-09-09

### Added

- Test A
## v0.85.4 - 2025-09-09

### Build

- Test B

Note the end of - Test A there is missing a newline.

[miniscruff]

If you swap after changelog version with https://changie.dev/config/#newlinesconfig-beforechangelogversion you might be better off

[davidolrik]

Awesome! - It was me that was blind, don't know why I didn't think of that.

Note: I also needed to update afterChangelogHeader to 0 (or just remove it as 0 is default)

[miniscruff]

I tried to make the new lines options as verbose as possible to account for these types of issues haha

[davidolrik]

Maybe create a diagram that shows all the elements, and where each newline config belongs?