diff --git a/docs/rules/a11y-explicit-heading.md b/docs/rules/a11y-explicit-heading.md
index a5f489b1..abd77b2c 100644
--- a/docs/rules/a11y-explicit-heading.md
+++ b/docs/rules/a11y-explicit-heading.md
@@ -14,7 +14,9 @@ enforces `as` usage to only be used for headings.
```jsx
import {Heading} from '@primer/react'
-;Heading without explicit heading level
+function ExampleComponent() {
+ return Heading without explicit heading level
+}
```
`as` must only be for headings (`h1`-`h6`)
@@ -22,7 +24,9 @@ import {Heading} from '@primer/react'
```jsx
import {Heading} from '@primer/react'
-;Heading component used as "span"
+function ExampleComponent() {
+ return Heading component used as "span"
+}
```
👍 Examples of **correct** code for this rule:
@@ -30,7 +34,9 @@ import {Heading} from '@primer/react'
```jsx
import {Heading} from '@primer/react'
-;Heading level 2
+function ExampleComponent() {
+ return Heading level 2
+}
```
## Options