diff --git a/content/components/inline-message.mdx b/content/components/inline-message.mdx
index b535edeea..33a57d545 100644
--- a/content/components/inline-message.mdx
+++ b/content/components/inline-message.mdx
@@ -17,7 +17,7 @@ import {Box} from '@primer/react'
## Usage
-InlineMessages inform users about the result of an action they took. In contrast to a [Banner](./banner) an InlineMessage can be very close the where the action has taken place.
+Inline messages inform users about the result of an action they took. In contrast to a [banner](./banner) an inline message can be very close the where the action has taken place.
For example below an input field, next to a button or within a table.
## Anatomy
@@ -45,9 +45,9 @@ For example below an input field, next to a button or within a table.
/>
- Critical
+#### Critical
- Use the `critical` variant for errors. For example, during form validation or when an action failed.
+Use the `critical` variant for errors. For example, during form validation or when an action failed.
@@ -66,10 +66,10 @@ For example below an input field, next to a button or within a table.
/>
- Warning
-
- Use the `warning` variant to inform about potential issues or risky changes. For example, important settings and possible connectivity concerns.
-
+#### Warning
+
+Use the `warning` variant to inform about potential issues or risky changes. For example, important settings and possible connectivity concerns.
+
@@ -86,9 +86,9 @@ For example below an input field, next to a button or within a table.
src="https://github.com/primer/design/assets/813754/d3b919f2-4564-43e1-ad31-498d35a09aac"
/>
-
+
Success
-
+
Use the `success` variant to indicate task completion or a successfully completed action. For example, to confirm settings have been saved.
@@ -107,11 +107,11 @@ For example below an input field, next to a button or within a table.
src="https://github.com/primer/design/assets/813754/d0fb73bd-d060-444e-b8c5-0aaff2a54cdc"
/>
-
- Unavailable
-
- Use the `unavailable` variant to inform users that a specific part of the UI could not be loaded. For example, when not being able to retrieve data in a table.
-
+
+#### Unavailable
+
+Use the `unavailable` variant to inform users that a specific part of the UI could not be loaded. For example, when not being able to retrieve data in a table.
+