commonmark-spec
commonmark-spec copied to clipboard
CommonMark spec, with reference implementations in C and JavaScript
I realize this pull request may be a bit premature, but I wanted to put it out there for people to have a look and give feedback. (Otherwise just merge...
Entities
As noted in [this thread](https://talk.commonmark.org/t/spec-issues-character-entity-references/2306), it might be desirable to change what the spec says about entities. Arguably the spec should not require that entities be replaced (in the parsing...
Void elements as [described in the HTML spec](http://w3c.github.io/html/syntax.html#void-elements) should not start a [CommonMark HTML block](http://spec.commonmark.org/0.26/#html-block), because void elements cannot have any content. The void elements are: > area base br...
Looking at the spec, under [List items](http://spec.commonmark.org/0.25/#list-items), I wish that the 6 rules ("1. Basic case", ...) had anchors, so that I can link to them from an implementation for...
I think it would be nice to clarify the interplay between [tabs](http://spec.commonmark.org/0.23/#tabs) and the indentation removal in [fenced code blocks](http://spec.commonmark.org/0.23/#fenced-code-blocks). What exactly gets removed? Example: `````` ⋅⋅``` →→foo ⋅→⋅bar ⋅⋅→baz...
It seems that the standard is defined regardless of the actual Unicode encoding scheme which is a good idea. However 333c7713fda24fe3444a59b664e3ca55fd45b32c defines a character to be any [Unicode code point](http://unicode.org/glossary/#code_point)....
HTML5 attribute names are specified as: > Attribute names must consist of one or more characters other than the space > characters, U+0000 NULL, U+0022 QUOTATION MARK ("), U+0027 >...
Per the spec, a fenced code block is started by a line that contains 0-3 spaces, 3 or more backticks, then 0+ non-backtick characters. It's ended by a line that...
#### Background The CommonMark spec prevents “actual” links (those with a reference (e.g., `[x]`), or those with a resource (e.g., `(x "y")`), from occurring inside each other: ```markdown [a [b](c)...
Numeric character references: Should HTML spec be followed for codes mapping to control characters
The spec [says this](https://spec.commonmark.org/0.31.2/#decimal-numeric-character-references): > Decimal numeric character references consist of `&#` + a string of 1--7 arabic digits + `;`. > A numeric character reference is parsed as the...