Update documentation for MD038/no-space-in-code to expand rationale (fixes #641).

This commit is contained in:
David Anson 2022-12-08 22:07:10 -08:00
parent 5eef37751b
commit a86998bf6f
3 changed files with 15 additions and 9 deletions

View file

@ -14,17 +14,19 @@ To fix this, remove any spaces adjacent to the backticks:
```
Note: A single leading and trailing space is allowed by the specification and
automatically trimmed (to allow for embedded backticks):
automatically trimmed (in order to allow for code spans that embed backticks):
```markdown
`` `backticks` ``
```
Note: A single leading or trailing space is allowed if used to separate code
span markers from an embedded backtick:
span markers from an embedded backtick (though the space is not trimmed):
```markdown
`` ` embedded backtick``
```
Rationale: Violations of this rule can lead to improperly rendered content.
Rationale: Violations of this rule are usually unintentional and may lead to
improperly-rendered content. If spaces beside backticks are intentional, this
rule can be disabled for that line or file.

View file

@ -1597,20 +1597,22 @@ To fix this, remove any spaces adjacent to the backticks:
```
Note: A single leading and trailing space is allowed by the specification and
automatically trimmed (to allow for embedded backticks):
automatically trimmed (in order to allow for code spans that embed backticks):
```markdown
`` `backticks` ``
```
Note: A single leading or trailing space is allowed if used to separate code
span markers from an embedded backtick:
span markers from an embedded backtick (though the space is not trimmed):
```markdown
`` ` embedded backtick``
```
Rationale: Violations of this rule can lead to improperly rendered content.
Rationale: Violations of this rule are usually unintentional and may lead to
improperly-rendered content. If spaces beside backticks are intentional, this
rule can be disabled for that line or file.
<a name="md039"></a>

View file

@ -22,17 +22,19 @@ To fix this, remove any spaces adjacent to the backticks:
```
Note: A single leading and trailing space is allowed by the specification and
automatically trimmed (to allow for embedded backticks):
automatically trimmed (in order to allow for code spans that embed backticks):
```markdown
`` `backticks` ``
```
Note: A single leading or trailing space is allowed if used to separate code
span markers from an embedded backtick:
span markers from an embedded backtick (though the space is not trimmed):
```markdown
`` ` embedded backtick``
```
Rationale: Violations of this rule can lead to improperly rendered content.
Rationale: Violations of this rule are usually unintentional and may lead to
improperly-rendered content. If spaces beside backticks are intentional, this
rule can be disabled for that line or file.