diff --git a/docs/badge/badge_link.rst b/docs/badge/badge_link.rst
index f5a7c1e582f6ea2f4333a308eab5ba112501e769..9a43d6d75b71f5663eccd6fe1505c978c3386bac 100644
--- a/docs/badge/badge_link.rst
+++ b/docs/badge/badge_link.rst
@@ -15,5 +15,5 @@ isolation, but there are current limiting resistors.
 
 The input protection can handle between +5v and -3v.
 
-For the micropython badge link API, see the :ref:`badge_link<py_badge_link>` API docs
+For the micropython badge link API, see the badge_link API docs
 
diff --git a/docs/badge/hardware_specs.rst b/docs/badge/hardware_specs.rst
index 5bf6f4d6754fbbc7f89b89b7f694b003c87c3bc4..f2d62302006cb36cee0320182f3736794a525a09 100644
--- a/docs/badge/hardware_specs.rst
+++ b/docs/badge/hardware_specs.rst
@@ -2,25 +2,33 @@ Hardware Specs
 ==============
 
 * ESP32-S3 SoC
+
    * 240MHz
    * 8MiB SPI RAM, 512KiB SRAM
    * 16MiB flash
    * WiFi (2.4GHz, b/g/n)
    * Bluetooth LE (no bluetooth audio)
+
 * Round display, 240x240px, compatible with GC9A01
 * Two speakers
 * Two 3.5mm ports
+
    * Headphone / line out and microphone / line in
    * :ref:`Badge Link`
+
       * Can be configured in each 3.5mm port (3.3v UART)
       * MIDI compatible (31250 baud UART)
 * USB-C
+
    * Two modes:
-     * USB Serial/JTAG (implemented in hardware)
-     * TinyUSB (for serial, mass storage, USB MIDI)
+
+      * USB Serial/JTAG (implemented in hardware)
+      * TinyUSB (for serial, mass storage, USB MIDI)
+
    * SBU1/SBU2 (sideband use) pins have UART RX/TX for early debug
    * Passive analog audio out
    * Not supported: USB host
+
 * 40 RGB LEDs (WS2812C)
 * MicroSD card slot
 * Accelerometer? XXX