Hi,
On 17 Jul 2019, at 23:57, Jon Murphy jcmurphy26@gmail.com wrote:
Does this mean using only the Basic Syntax (John Gruber’s original design)? In my opinion, the basic syntax is not complete. I’d strongly suggest using the extended syntax (https://www.markdownguide.org/extended-syntax).
No, this is the extended syntax that we are using here.
Will HTML be restricted? From Basic Syntax Markdown Guide (https://www.markdownguide.org/basic-syntax/):
No, not for now. But there is absolutely no point in using it.
Everything should be markdown. I will implement filtering HTML tags soon when there is time for it.
Note: Using Markdown doesn't mean that you can't also use HTML. You can add HTML tags to any Markdown file. This is helpful if you prefer certain HTML tags to Markdown syntax. For example, some people find that it's easier to use HTML tags for images.
Please don’t do that. What is the point of markdown in the first place then?
This will break the layout, make it impossible to render the documentation into PDF and many things more.
-Michael
I changed from the markdown2 python module back to the default one which seems to be used more often. I think we should stick very closely to the original markdown syntax. I find that one quite loose already and it allows 10 different ways to do the same thing, but this is what people are used to.