search

omg-dmn-taskforce / plain-text-spec

A repo for prototyping around plain text specification formats like Markdown, AsciiDoc and LaTeX
1 stars 0 forks source link

Try out Markdown #5

Open barmac opened 1 year ago

barmac commented 1 year ago
barmac commented 1 year ago

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 commented 1 year ago

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

falko commented 1 year ago

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 commented 1 year ago

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

barmac commented 1 year ago

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

barmac commented 1 year ago

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

falko commented 1 year ago

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 commented 1 year ago

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