search

brainhack-proceedings / template

Template repository to generate a brainhack proceeding webpage & article.
2 stars 1 forks source link

A markdown list in `report.md` breaks compilation #3

Open r03ert0 opened 3 years ago

r03ert0 commented 3 years ago

In the #Introduction section I had a paragraph with text. Compilation is broken if a list like this is added:

1. The changes of position and velocity as given by Newton's laws of motion.
2. The stresses as given by the elasticities and motions, also taking into account the
osmotic pressures as given from the chemical data.
3. The chemical reactions.
4. The diffusion of the chemical substances. The region in which this diffusion is possible is given from the mechanical data.

although that's valid markdown.

It should be maybe indicated which is the valid subset of markdown that works?

agahkarakuzu commented 3 years ago

@r03ert0 lists should be added using latex convention, I think this is because of the pandoc version/latex template etc. we are using. Bringing in more markdown-native texting into the process is one of the open development issues.

r03ert0 commented 3 years ago

ok :) For the moment, I think it's just good to let people know they shouldn't use some markdown syntax. Is there a document showing which is the subset of markdown that pandoc recognises? Currently, I'm adding text to a report.md file little by little to discover what works and what doesn't...

agahkarakuzu commented 3 years ago

Thank you so much, we definitely need this to improve our documentation!