Try out Markdown

[barmac]

• Convert DMN Word to Markdown with pandoc
• Explore from there

[barmac]

GitHub flavored markdown seems to not support heading ids, cf. https://github.com/omg-dmn-taskforce/plain-text-spec/blob/5-markdown/markdown/dmn-1-5.md#annexes--annexes-unnumbered

[falko]

Native IDE support shows the popularity of Markdown: https://code.visualstudio.com/docs/languages/markdown

[falko]

According to https://github.blog/2017-03-14-a-formal-spec-for-github-markdown/ GitHub uses https://github.com/vmg/sundown as a library.

[barmac]

GitHub Flavored Markdown is specified at https://github.github.com/gfm/

[barmac]

If we want to render HTML from GFM, the tool for that is https://github.com/github/cmark-gfm

[barmac]

The diff between documents can be rendered with git diff --word-diff

[falko]

The diff between documents can be rendered with git diff --word-diff

I'm not sure, I'll call that "rendered" but it could be a workaround. Also I tried it with the AsciiDoc PR #4 and got mixed results.

[barmac]

Features we may need which are not supported out of the box:

• table of contents
• links to non-headings (e.g. figures) -> this can be done via custom html, e.g. <span id=figure>figure</span>