Descriptions that are helpful for teaching beginners are rarely sufficiently general or accurate for a spec, and spec descriptions tend to be terrible for beginners. We never imagined that beginners would want to learn CommonMark by reading the spec. There should be separate documents for this purpose: see the thread Markdown Tutorial contest feedback.
1 Like