Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The website conflates emphasis with italic and bold #69

Open
DominoPivot opened this issue Oct 23, 2023 · 1 comment
Open

The website conflates emphasis with italic and bold #69

DominoPivot opened this issue Oct 23, 2023 · 1 comment

Comments

@DominoPivot
Copy link

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
Copy link
Author

Unrelated but poignant: While filing this issue I noticed that Github stripped the <cite> element from my Markdown, despite not being forbidden by the GFM specification.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant