-
Notifications
You must be signed in to change notification settings - Fork 179
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Markdown templates with wrong syntax #160
Comments
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 |
@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. ;-) |
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" |
@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... |
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. |
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? |
I wasn't aware that there were more download options than published on arc42.org. |
added several additional download formats... |
Additionally to Ticket #159 the markdown syntax is not followed.
For example:
{placeholder}
should be used instead of<placeholder>
because it might be interpreted as html: *\<Erläuternder Text>*
does not exist::: formalpara-title
{#_ebene_2}
should be removedThe text was updated successfully, but these errors were encountered: