It seems like an obviously missing thing is a page that describes how users should write markdown, in a few sentences. Otherwise you are just going to get incorrect summaries of the spec.

You certainly can't point users to the spec, which is incredibly lengthy.