Emphasis

How to use emphasis to highlight text.

---

Italic

Use one (1) asterisk * marker to generate spans for italic formatted text.

remark-lint: emphasis-marker (opens new window)

👍 Correct code for this rule:

*One*
*Two*

👎 Incorrect code for this rule:

__One__
__Two__

Bold

Use two (2) asterisk * marker to generate spans for bold formatted text.

remark-lint: emphasis-marker (opens new window) and strong-marker (opens new window)

👍 Correct code for this rule:

**One**
**Two**

👎 Incorrect code for this rule:

*One*

No header replacement

Do not use emphasis elements (bold or italics) to introduce a multi line named section. Use headers instead which is exactly the semantic meaning of headers.

As a consequence, many implementations add useful behaviors to headers and not to emphasis elements, such as automatic ID generation (anchor) to make it effortless to refer to the header later on.

Use a level 6 header if the meaning of the header section should not stand out great.

remark-lint: no-emphasis-as-heading (opens new window)

👍 Correct code for this rule:

## One

The summer is awesome!

## Two

Spring is nice, too!

###### One

The summer is nice!

###### Two

Spring is awesome!

👎 Incorrect code for this rule:

**One**

The summer is beautiful!

__Two__

Spring is great!

No inner spacing

Do not use inner spaces for any markers.

remark-lint: no-inline-padding (opens new window)

👍 Correct code for this rule:

**One**
*Two*

👎 Incorrect code for this rule:

** One **
* Two *

**      One **
* Two            *