diff --git a/docs/reference/pins/i2c-read-buffer.md b/docs/reference/pins/i2c-read-buffer.md
index ccbddfcb082..d061b2ab375 100644
--- a/docs/reference/pins/i2c-read-buffer.md
+++ b/docs/reference/pins/i2c-read-buffer.md
@@ -10,7 +10,9 @@ A device connected to the I2C pins on the @boardname@ at the address is selected
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/i2c-read-number.md b/docs/reference/pins/i2c-read-number.md
index d27e5d2b786..9211ec73813 100644
--- a/docs/reference/pins/i2c-read-number.md
+++ b/docs/reference/pins/i2c-read-number.md
@@ -8,7 +8,9 @@ pins.i2cReadNumber(0, NumberFormat.Int8LE, false);
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/i2c-write-buffer.md b/docs/reference/pins/i2c-write-buffer.md
index 43f573a9795..1be771ca6e9 100644
--- a/docs/reference/pins/i2c-write-buffer.md
+++ b/docs/reference/pins/i2c-write-buffer.md
@@ -10,7 +10,9 @@ A device connected to the I2C pins on the @boardname@ at the address is selected
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/i2c-write-number.md b/docs/reference/pins/i2c-write-number.md
index b630d9ee74c..879ad59f91a 100644
--- a/docs/reference/pins/i2c-write-number.md
+++ b/docs/reference/pins/i2c-write-number.md
@@ -8,7 +8,9 @@ pins.i2cWriteNumber(0, 0, NumberFormat.Int8LE, true);
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/on-pulsed.md b/docs/reference/pins/on-pulsed.md
index 4ec62f90b63..ed652f917e3 100644
--- a/docs/reference/pins/on-pulsed.md
+++ b/docs/reference/pins/on-pulsed.md
@@ -8,7 +8,9 @@ pins.onPulsed(DigitalPin.P0, PulseValue.High, () => { });
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/pulse-duration.md b/docs/reference/pins/pulse-duration.md
index a03e64cdff7..d9d3e2f0986 100644
--- a/docs/reference/pins/pulse-duration.md
+++ b/docs/reference/pins/pulse-duration.md
@@ -10,7 +10,9 @@ A pin pulse is detected in the [onPulsed](/reference/pins/on-pulsed) event. You
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/pulse-in.md b/docs/reference/pins/pulse-in.md
index 4b580870e32..00b5c751606 100644
--- a/docs/reference/pins/pulse-in.md
+++ b/docs/reference/pins/pulse-in.md
@@ -15,7 +15,9 @@ Please read the [page about pins](/device/pins) carefully.
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/set-events.md b/docs/reference/pins/set-events.md
index 3eac8aba89c..5396f640102 100644
--- a/docs/reference/pins/set-events.md
+++ b/docs/reference/pins/set-events.md
@@ -8,7 +8,9 @@ pins.setEvents(DigitalPin.P0, PinEventType.Edge);
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/spi-format.md b/docs/reference/pins/spi-format.md
index 7272b5c3ca9..a67d3e6d93e 100644
--- a/docs/reference/pins/spi-format.md
+++ b/docs/reference/pins/spi-format.md
@@ -10,7 +10,9 @@ The data sent over a SPI connection has a number of _bits_ to represent each val
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/spi-frequency.md b/docs/reference/pins/spi-frequency.md
index 7dd812415ee..2ebce5efe72 100644
--- a/docs/reference/pins/spi-frequency.md
+++ b/docs/reference/pins/spi-frequency.md
@@ -10,7 +10,9 @@ The @boardname@ sets the rate of data transfer and control timing for a SPI conn
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/spi-pins.md b/docs/reference/pins/spi-pins.md
index 3d75d1802f3..3887d09eeec 100644
--- a/docs/reference/pins/spi-pins.md
+++ b/docs/reference/pins/spi-pins.md
@@ -10,7 +10,9 @@ To configure the @boardname@ to write to an external device using a SPI connecti
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~
 
diff --git a/docs/reference/pins/spi-write.md b/docs/reference/pins/spi-write.md
index b7345f51cc1..70fdc950ed8 100644
--- a/docs/reference/pins/spi-write.md
+++ b/docs/reference/pins/spi-write.md
@@ -10,7 +10,9 @@ Data values are written to a SPI slave device connected to the @boardname@ by th
 
 ### ~ hint
 
-**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
+#### Simulator
+
+This function needs real hardware to work with. It's not supported in the simulator.
 
 ### ~