commonmark-web icon indicating copy to clipboard operation
commonmark-web copied to clipboard

The website conflates emphasis with italic and bold

Open DominoPivot opened this issue 8 months ago • 1 comments

The quick reference and the tutorial on commonmark.org says that asterisks or underscores are used for italic and bold, terms that are never used in the specification.

Both the CommonMark spec and the original Markdown description indicate that such syntax is for emphasis and strong emphasis, and imply that they are equivalent to <em> and <strong>. This aligns with older HTML specifications and terminology, and whether the CommonMark specification should be updated to more closely match HTML: The Living Standard is a separate issue better discussed on the commonmark-spec repository or forums.

But at the very least, I believe the quick reference and tutorial should match the specification, and not have *Italic* and **Bold** as examples.

DominoPivot avatar Oct 23 '23 00:10 DominoPivot