diff --git a/boards/makerdiary/nrf52832_mdk/doc/index.rst b/boards/makerdiary/nrf52832_mdk/doc/index.rst
index 2c8667bfacd..61ec37c09e8 100644
--- a/boards/makerdiary/nrf52832_mdk/doc/index.rst
+++ b/boards/makerdiary/nrf52832_mdk/doc/index.rst
@@ -1,7 +1,4 @@
-.. _nrf52832_mdk:
-
-nRF52832-mdk
-#################
+.. zephyr:board:: nrf52832_mdk
 
 Overview
 ********
diff --git a/boards/makerdiary/nrf52840_mdk/doc/index.rst b/boards/makerdiary/nrf52840_mdk/doc/index.rst
index 6e0b24b65f2..e2bc31dabca 100644
--- a/boards/makerdiary/nrf52840_mdk/doc/index.rst
+++ b/boards/makerdiary/nrf52840_mdk/doc/index.rst
@@ -1,7 +1,4 @@
-.. _nrf52840_mdk:
-
-nRF52840-mdk
-#################
+.. zephyr:board:: nrf52840_mdk
 
 Overview
 ********
diff --git a/boards/makerdiary/nrf52840_mdk_usb_dongle/doc/index.rst b/boards/makerdiary/nrf52840_mdk_usb_dongle/doc/index.rst
index 82202ec51ac..ac4743c7748 100644
--- a/boards/makerdiary/nrf52840_mdk_usb_dongle/doc/index.rst
+++ b/boards/makerdiary/nrf52840_mdk_usb_dongle/doc/index.rst
@@ -1,7 +1,4 @@
-.. _nrf52840_mdk_usb_dongle:
-
-nRF52840 MDK USB Dongle
-#######################
+.. zephyr:board:: nrf52840_mdk_usb_dongle
 
 Overview
 ********
@@ -15,12 +12,6 @@ Bluetooth5/Tread/802.15.4/ANT/2.4GHz multiprotocol node or development
 board. Alternatively the USB Dongle can be used as a Network Co-Processor(NCP)
 with a simple connection to a PC or other USB enabled device.
 
-.. figure:: nrf52840-mdk-usb-dongle-pinout.jpg
-     :align: center
-     :alt: nRF52840 MDK USB Dongle
-
-     nRF52840 MDK USB Dongle
-
 See `nrf52840-mdk-usb-dongle website`_ for more information about the development
 board and `nRF52840 website`_ for the official reference on the IC itself.