Skip to content

MD053: optinally allow duplicate definitions #2043

@amezin

Description

@amezin

So I've been writing a long changelog in markdown format, with references to GitHub pull requests and users, in the following format:

## v1.1
### Added
- Feature 1 by [@user1] in [#1]
- Feature 2
...

[#1]: https://www.github.com/my/repo/pull/1
[@user1]: https://www.github.com/user1

## v1.0
### Added
- Feature 0 - also by [@user1]
...

[@user1]: https://www.github.com/user1

I placed link definitions at the end of every version section.

When the same person contributed to two different versions, I added a link definition to every version section - and got MD053 error.

Of course, I can just remove one of the duplicates - but it's a lot easier to read the document as plain text when link definitions are close to the places where they are used.

An option to allow duplicate definitions, while keeping all other checks enabled, would be great. Likely it should check that definitions with the same label also have the same destination (i.e. they are not conflicting with each other).

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions