on Subhead-heading docs
diff --git a/docs/content/components/subhead.md b/docs/content/components/subhead.md
index 44ffbb47f0..10fbba6b5f 100644
--- a/docs/content/components/subhead.md
+++ b/docs/content/components/subhead.md
@@ -8,13 +8,13 @@ bundle: subhead
---
-The basic Subhead consists of a `.Subhead` container, which has a light gray bottom border. Use `.Subhead-heading` for the heading itself. It's an `
` sized heading with normal font-weight.
+The basic Subhead consists of a `.Subhead` container, which has a light gray bottom border. Use `.Subhead-heading` for the heading itself. It is styled as an `` sized heading with normal font-weight.
Use a heading element whenever possible as they can be used as navigation for assistive technologies, and avoid skipping levels.
```html live title="Subhead"
-
Plain subhead
+
Plain subhead
```
@@ -22,7 +22,7 @@ To add a top margin to the Subhead, use `.Subhead--spacious`. This is useful for
```html live title="Spacious Subhead"
-
Spacious subhead
+
Spacious subhead
```
@@ -30,7 +30,7 @@ You can add a one line description to the subhead with `.Subhead-description`.
```html live title="Subhead with description"
-
Subhead with description
+
Subhead with description
The subhead is a subdued header style with a light bottom border.
```
@@ -39,7 +39,7 @@ For longer descriptions, it is recommended that you use a paragraph below the Su
```html live title="Subhead with longer description"
-
Plain subhead
+
Plain subhead
This is a longer description that is sitting below the Subheader. It's much longer than a description that could sit comfortably in the Subhead. It might even have bold text. Click to learn more.
@@ -50,12 +50,12 @@ You can add a button or something to the right of `.Subhead-heading` with the `.
```html live title="Subhead with actions"
-
Subhead with button
+
Subhead with button
-
Subhead with link
+
Subhead with link
```
@@ -64,7 +64,7 @@ Use all the elements together to create a Subhead with actions and a description
```html live title="Subhead with actions and description"
-
Subhead with actions and description
+
Subhead with actions and description
The subhead is a subdued header style with a light bottom border.
@@ -74,6 +74,6 @@ Use the `.Subhead-heading--danger` modifier to make the text bold and red. This
```html live title="Subhead danger"
-
Danger zone
+
Danger zone
```