Read the piece on johnmacfarlane.net ↗
Every claim below was made in this piece, quoted word for word and numbered in the order the piece makes them, so you can read it there rather than take our word for it. The sentence above each quote is our reading of the claim, not their wording. Each quote was checked against a stored copy of the page at build time; where the two differ, the quote is the fact.
Their wordsBut this respect for the past has made the CommonMark spec a very complicated beast.
Their wordsthe burdens of maintaining backwards compatibility are light in comparison with the enormous practical costs of moving existing systems to a new light markup language.
Our reading
Making intraword emphasis harder is a good tradeoff for simpler emphasis rules in Markdown.
Their wordsIntraword emphasis is extremely rare, so it’s a good tradeoff to make it a little harder, in exchange for simplifying the rules (and conceptual model) for emphasis in general.
Their wordsSince we have fenced code blocks, we don’t need indented code blocks. So, we can just get rid of them.
Their wordsInstead of passing through raw HTML, we should introduce a special syntax that allows passing through raw content of any format.
Their wordsWe should require a blank line between paragraph text and a list. Always.
Keep reading