Add markdown as an output format for when creating a change log

[bdoughan-snow]

Is your feature request related to a problem? Please describe.

I am looking for a way to maintain a living change log listing all the changes since the last release. I like to easily be able to view this within GitHub as markdown.

Describe the solution you'd like

I would like to be able to make the following call and have markdown produced:

oasdiff changelog data/openapi-test1.yaml data/openapi-test3.yaml -f markdown

Describe alternatives you've considered

As a workaround the text output format could be used.

Additional context

Ideally this could be used in conjunction with the oasdiff-action GitHub action and the resulting markdown checked into the repo.

[reuvenharrison]

Hi @bdoughan-snow,
Did you try the githubactions format?

oasdiff breaking data/openapi-test1.yaml data/openapi-test3.yaml -f githubactions

It is designed to create a summary in Github actions.
We could support this for changelog too.
Does this solve your requirement?

[bdoughan-snow]

Hi @reuvenharrison

It does not appear so. I tried the following command:
oasdiff breaking .\examples\pet-store.yaml .\examples\pet-store.json -f githubactions > foo.md

When I looked at foo.md in GitHub, it looks like the following: