Markdown templates with wrong syntax about arc42-template HOT 8 OPEN

Benjamin, you or we should check the pandoc conversion - as the Markdown version of the template is generated from the original AsciiDoc source

So instead of cleaning the markdown manually, I suggest we find a better/cleaner way of generating or transforming adoc->markdown...

cc @rdmueller

from arc42-template.

@gernotstarke definitely generating from source is the way of choice! I've not looked into pandoc yet - so if one of you guys has the chance to look into it that would be great. ;-)

from arc42-template.

yes, we should try to configure pandoc or look for another converter and not try to clean it manually.

the main problem I see is that there are so many markdown dialects. So which should we use?

For instance, the original markdown is not capable of generating tables: https://daringfireball.net/projects/markdown/syntax

For those who want to play around with the settings - the code we use to generate markdown can be found here: https://github.com/arc42/arc42-generator/blob/master/subBuild.gradle#L185

We already generate "markdown", "strict markdown" and "github markdown"

from arc42-template.

@benjaminburkhardt - neither @rdmueller nor myself have a chance to look into this issue in the near future, therefore I ask for your help.

I leave this issue open, maybe other folks have time and/or ideas...

from arc42-template.

I think "strict markdown" already solves all of the problems mentioned above. But it does not seem to be available for download on arc42.org/download but only from this repository.

from arc42-template.

markdown is available... https://github.com/arc42/arc42-template/raw/master/dist/arc42-template-EN-plain-markdown.zip

do you suggest to add "markdown-strict" as additional download on arc42.org?

from arc42-template.

I wasn't aware that there were more download options than published on arc42.org.
It was only by chance after finding this issue that I found the markdown-strict template. Maybe it would be helpful for others if it was directly available on the website. So my answer to your question would be "yes".

from arc42-template.

added several additional download formats...

from arc42-template.