Use CommonMark instead of loosely defined Markdown flavour #361
I think that for documentation purposes, the syntax should be precisely defined in advance to allow long-term maintainability, which Gruber's Markdown doesn't fulfill. Therefore I'm suggesting switching from Markdown to CommonMark (there is an existing module https://github.com/rolandshoemaker/CommonMark-py).
I don't think I see why documentation specifically needs the syntax to be more less precisely defined than other prose, but that is another discussion :)
CommonMark is an intersting project, I appreciate it's goals and may be a direction we wish to take at some point. However, at present it is too young and I don't see any real advantages to switching at this point.
So, we should take note of this and keep an eye on it for the future.