Update markdown.md
What does this MR do?
In the announcement on the Commonmark Discourse, I said that there were some inconsistencies in the Markdown parser documentation. This contribution improves some of that, but not quite all of it.
- moves (sub)sections into proper places
- adds a distinction for the term GFM where necessary, because the acronym is also used for GitHub Flavored Markdown which is slightly different
- merges three tables in Special GitLab References into a single one, without adding any examples.
What are the relevant issue numbers?
https://gitlab.com/gitlab-org/gitlab-ce/issues/52250
Does this MR meet the acceptance criteria?
-
Changelog entry added, if necessary -
Documentation created/updated -
Tests added for this feature/bug -
Conforms to the code review guidelines -
Conforms to the merge request performance guidelines -
Conforms to the style guides -
Conforms to the database guides
Edited by Brett Walker