Specify Markdown statements

[niemela]

There should be a section specifying Markdown statements (similar to the section specifying LaTeX).

I think the Markdown dialect we want to us is:

• CommonMark
• + $ and $$ for math
• + tables
• + footnotes

Also we should consider equivalents of all the commands defined for LaTeX:

• \problemname
• \illustration
• \nextsample
• \remainingsamples
  We might not need all of them, but definitely the sample ones.

I would suggest using {{ }} syntax for these. E.g. {{nextsample}} for including the next sample.

[mzuenni]

using {{ }} might conflict with Constants?

[RagnarGrootKoerkamp]

I think it's nice to actually have the same syntax; both are some kinda of problem-package owned templating, and {{unknown}} is left alone by variable substitution.

[mzuenni]

but then {{problemname}} will work in markdown but not in latex whereas "normal" constant work everywhere? that could be frustrating for users ^^'

[Matistjati]

The reference implementation (so far): Kattis/problemtools#274

[Matistjati]

We have decided that:

• We will not support {{problemname}}. You should use problem.yaml, and we will automatically add the problem name to the top of the statement. This needs to be specced (maybe it already is?)
• We will not support {{includegraphics}}, as the commonmark syntax for images is simpler.
• {{nextsample}} and {{remainingsamples}} will be supported

[niemela]

@Matistjati Gentle nudge!

[Matistjati]

First draft is done. Are there any opinions on it? #386

[niemela]

Closing this as fixed by #386