Tags: emphasis
Aliases: emphasis-style
Parameters:
style
: Emphasis style (string
, defaultconsistent
, valuesasterisk
/consistent
/underscore
)
Fixable: Some violations can be fixed by tooling
This rule is triggered when the symbols used in the document for emphasis do not match the configured emphasis style:
*Text*
_Text_
To fix this issue, use the configured emphasis style throughout the document:
*Text*
*Text*
The configured emphasis style can be a specific symbol to use ("asterisk", "underscore"), or can require that usage be consistent within the document.
Note: Emphasis within a word is restricted to "asterisk" in order to avoid unwanted emphasis for words containing internal underscores like_this_one.
Rationale: Consistent formatting makes it easier to understand a document.