Feature Request: Convert ADF to Markdown 😢

[jamie-wearsafe]

I'm writing a GitHub action currently that takes Jira Issues, and Jira sprints and creates GitHub Issues, and Github Milestones.

[bruno-morel]

Ah. the opposite then? :)
The parser inside this is probably invert-able...
How far this need to go? Is it just batch, or does it need to do 2 way sync/diffing?

[xmedeko]

Get the ADF to HTML by API param expand=renderedFields, then you can use e.g. https://github.com/mixmark-io/turndown to convert HTML to Markdown.

Also see https://jira.atlassian.com/browse/JRACLOUD-77436 and the library https://bitbucket.org/atlassian/atlaskit-mk-2/src/master/packages/editor/editor-markdown-transformer/

[julianlam]

It's also prudent to mention that it is not possible to translate ADF to Markdown in a complete way as the formats are not 1:1 compatible. ADF contains a superset of Markdown's features, and so you wouldn't be able to translate a lot of types (e.g. mention, media, panel, etc.) to markdown equivalents, as they don't exist.

It's still worth doing, so long as the source ADF just contains basic formatting, so I might end up creating a library for it.

[julianlam]

I made a library for it 😄 https://github.com/julianlam/adf-to-md