Emphasis Rules
Rules for formatting bold and italic text.
Rules in This Category
| Rule | Description | Auto-fix |
|---|---|---|
| MD036 | Emphasis used instead of heading | No |
| MD037 | Spaces inside emphasis markers | Yes |
| MD049 | Emphasis style consistency | Yes |
| MD050 | Strong emphasis style consistency | Yes |
Overview
Emphasis rules ensure consistent formatting of bold (**text**) and italic
(*text*) text throughout your documents.
Common Issues
-
Using
**bold**on a line by itself as a pseudo-heading -
Spaces inside markers like
**bold**that may not render -
Mixing asterisks and underscores inconsistently
Best Practices
- Use real headings (
##) instead of bold text for sections - Keep emphasis markers tight against text (no internal spaces)
- Choose one style (asterisks or underscores) and use it consistently