diff --git a/boards/e104-bt5010a-tb/doc.txt b/boards/e104-bt5010a-tb/doc.md
similarity index 99%
rename from boards/e104-bt5010a-tb/doc.txt
rename to boards/e104-bt5010a-tb/doc.md
index bd9b786483..f9f05cd7d8 100644
--- a/boards/e104-bt5010a-tb/doc.txt
+++ b/boards/e104-bt5010a-tb/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_e104-bt5010a-tb E104-BT5010A Test Board
@ingroup boards
@brief Support for the Ebyte E104-BT5010A Test Board (nRF52810)
@@ -27,5 +26,3 @@ Use the `term` target to connect to the board serial port
```
make BOARD=e104-bt5010a-tb -C examples/basic/hello-world term
```
-
- */
diff --git a/boards/e104-bt5011a-tb/doc.txt b/boards/e104-bt5011a-tb/doc.md
similarity index 99%
rename from boards/e104-bt5011a-tb/doc.txt
rename to boards/e104-bt5011a-tb/doc.md
index 622bb487a7..d70849c381 100644
--- a/boards/e104-bt5011a-tb/doc.txt
+++ b/boards/e104-bt5011a-tb/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_e104-bt5011a-tb E104-BT5011A Test Board
@ingroup boards
@brief Support for the Ebyte E104-BT5011A Test Board (nRF52811)
@@ -27,5 +26,3 @@ Use the `term` target to connect to the board serial port
```
make BOARD=e104-bt5011a-tb -C examples/basic/hello-world term
```
-
- */
diff --git a/boards/e180-zg120b-tb/doc.txt b/boards/e180-zg120b-tb/doc.md
similarity index 98%
rename from boards/e180-zg120b-tb/doc.txt
rename to boards/e180-zg120b-tb/doc.md
index a4486fe2e3..0b10e7c6f4 100644
--- a/boards/e180-zg120b-tb/doc.txt
+++ b/boards/e180-zg120b-tb/doc.md
@@ -1,7 +1,6 @@
-/**
- * @defgroup boards_e180-zg120b-tb Ebyte E180-ZG120B-TB Test Board
- * @ingroup boards
- * @brief Support for Ebyte E180-ZG120B-TB Test Board
+@defgroup boards_e180-zg120b-tb Ebyte E180-ZG120B-TB Test Board
+@ingroup boards
+@brief Support for Ebyte E180-ZG120B-TB Test Board
## Overview

@@ -261,5 +260,4 @@ the usage of the [GNU Tools for ARM Embedded Processors](https://developer.arm.c
toolchain.
## License information
-* Ebyte' EMLIB: zlib-style license (permits distribution of source).
- */
+Ebyte' EMLIB: zlib-style license (permits distribution of source).
diff --git a/boards/ek-lm4f120xl/doc.txt b/boards/ek-lm4f120xl/doc.md
similarity index 94%
rename from boards/ek-lm4f120xl/doc.txt
rename to boards/ek-lm4f120xl/doc.md
index b5e61641a2..81e1e5c92d 100644
--- a/boards/ek-lm4f120xl/doc.txt
+++ b/boards/ek-lm4f120xl/doc.md
@@ -1,5 +1,3 @@
-/**
@defgroup boards_ek-lm4f120xl EK-LM4F120XL
@ingroup boards
@brief Support for the Stellaris Launchpad LM4F120 board
- */
diff --git a/boards/f4vi1/doc.txt b/boards/f4vi1/doc.md
similarity index 92%
rename from boards/f4vi1/doc.txt
rename to boards/f4vi1/doc.md
index 5941a5c32c..04c7640927 100644
--- a/boards/f4vi1/doc.txt
+++ b/boards/f4vi1/doc.md
@@ -1,5 +1,3 @@
-/**
@defgroup boards_f4vi1 F4VI1
@ingroup boards
@brief Support for the F4VI1 board
- */
diff --git a/boards/firefly/doc.txt b/boards/firefly/doc.md
similarity index 96%
rename from boards/firefly/doc.txt
rename to boards/firefly/doc.md
index f8fd037e15..222689f659 100644
--- a/boards/firefly/doc.txt
+++ b/boards/firefly/doc.md
@@ -1,7 +1,6 @@
-/**
- * @defgroup boards_firefly Firefly Board
- * @ingroup boards
- * @brief Support for the Firefly board
+@defgroup boards_firefly Firefly Board
+@ingroup boards
+@brief Support for the Firefly board
Zolertia Firefly platform
============================================
@@ -128,5 +127,3 @@ More Reading
[zolertia-wiki]: https://github.com/Zolertia/Resources/wiki
[cc1200]: http://www.ti.com/product/cc1200 "CC1200"
[cc2538]: http://www.ti.com/product/cc2538 "CC2538"
-
-*/
diff --git a/boards/frdm-k22f/doc.txt b/boards/frdm-k22f/doc.md
similarity index 93%
rename from boards/frdm-k22f/doc.txt
rename to boards/frdm-k22f/doc.md
index 956135da92..d4ea1425fd 100644
--- a/boards/frdm-k22f/doc.txt
+++ b/boards/frdm-k22f/doc.md
@@ -1,5 +1,3 @@
-/**
@defgroup boards_frdm-k22f NXP FRDM-K22F Board
@ingroup boards
@brief Support for the NXP FRDM-K22F
- */
diff --git a/boards/frdm-k64f/doc.txt b/boards/frdm-k64f/doc.md
similarity index 99%
rename from boards/frdm-k64f/doc.txt
rename to boards/frdm-k64f/doc.md
index 821621b851..dd12048e6f 100644
--- a/boards/frdm-k64f/doc.txt
+++ b/boards/frdm-k64f/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_frdm-k64f NXP FRDM-K64F Board
@ingroup boards
@brief Support for the NXP FRDM-K64F
@@ -98,4 +97,3 @@ in `boards/frdm-k64f/dist/openocd.cfg`
Solution 3:
+ Ask Deep Thought
- */
diff --git a/boards/frdm-kw41z/doc.md b/boards/frdm-kw41z/doc.md
new file mode 100644
index 0000000000..be00717702
--- /dev/null
+++ b/boards/frdm-kw41z/doc.md
@@ -0,0 +1,3 @@
+@defgroup boards_frdm-kw41z Freescale FRDM-KW41Z Board
+@ingroup boards
+@brief Support for the FRDM-KW41Z
diff --git a/boards/frdm-kw41z/doc.txt b/boards/frdm-kw41z/doc.txt
deleted file mode 100644
index 26894cc979..0000000000
--- a/boards/frdm-kw41z/doc.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-/**
- * @defgroup boards_frdm-kw41z Freescale FRDM-KW41Z Board
- * @ingroup boards
- * @brief Support for the FRDM-KW41Z
- */
\ No newline at end of file
diff --git a/boards/gba_cartridge/doc.txt b/boards/gba_cartridge/doc.md
similarity index 91%
rename from boards/gba_cartridge/doc.txt
rename to boards/gba_cartridge/doc.md
index c02fb4b569..15092d7faf 100644
--- a/boards/gba_cartridge/doc.txt
+++ b/boards/gba_cartridge/doc.md
@@ -1,5 +1,3 @@
-/**
@defgroup boards_gba_cartridge GBA
@ingroup boards
@brief Support for the GBA
- */
diff --git a/boards/gd32vf103c-start/doc.txt b/boards/gd32vf103c-start/doc.md
similarity index 99%
rename from boards/gd32vf103c-start/doc.txt
rename to boards/gd32vf103c-start/doc.md
index b23b962e91..1c6b2c20c7 100644
--- a/boards/gd32vf103c-start/doc.txt
+++ b/boards/gd32vf103c-start/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_gd32vf103c_start GD32VF103C-START
@ingroup boards
@brief Support for the GD32VF103C-START board
@@ -99,5 +98,3 @@ needs to be connected to the USB connector labeled OTG.
@note It is safe to keep the jumper at JP2 in "Usart" position or even
remove the jumper with RIOT. PA9 is still used as UART/TXD and VBUS
sensing is disabled anyway.
-
- */
diff --git a/boards/generic-cc2538-cc2592-dk/doc.txt b/boards/generic-cc2538-cc2592-dk/doc.md
similarity index 99%
rename from boards/generic-cc2538-cc2592-dk/doc.txt
rename to boards/generic-cc2538-cc2592-dk/doc.md
index f463e2f886..a1eb089106 100644
--- a/boards/generic-cc2538-cc2592-dk/doc.txt
+++ b/boards/generic-cc2538-cc2592-dk/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_generic_cc2538_cc2592_dk Generic CC2538-CC2592-DK Board
@ingroup boards
@brief Support for the 3rd party CC2538-CC2592-DK board
@@ -80,5 +79,3 @@ make BOARD=generic-cc2538-cc2592-dk debug
@note By default OpenOCD is used for debugging. While debugging works fine
with OpenOCD, flashing is only supported via the bootloader or `jlink`.
-
- */
diff --git a/boards/hamilton/doc.txt b/boards/hamilton/doc.md
similarity index 97%
rename from boards/hamilton/doc.txt
rename to boards/hamilton/doc.md
index a9060c8ed5..092eebfe6c 100644
--- a/boards/hamilton/doc.txt
+++ b/boards/hamilton/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_hamilton HamiltonIoT Hamilton
@ingroup boards
@brief Support for the HamiltonIoT Hamilton board.
@@ -6,5 +5,3 @@
@image html "https://github.com/immesys/baseliner/raw/fa1f224b0a6eaf101dfeb2abe3127ecc5acd0986/misc/hamilton-sm.jpg" "Image of the Hamilton IoT board next to coin" width=80%
See https://github.com/hamilton-mote/hw for more details on the hardware.
-
- */
diff --git a/boards/hip-badge/doc.txt b/boards/hip-badge/doc.md
similarity index 99%
rename from boards/hip-badge/doc.txt
rename to boards/hip-badge/doc.md
index 7fdc63d509..5375f9b262 100644
--- a/boards/hip-badge/doc.txt
+++ b/boards/hip-badge/doc.md
@@ -1,4 +1,3 @@
-/**
@defgroup boards_hip_badge HiP Badge
@ingroup boards_esp32c3
@brief Support for the Hacking in Parallel Badge
@@ -51,5 +50,3 @@ The event (and badge) were organized on short notice (6 Weeks), so there are som
- [Badge Clinic](https://wiki.hip-berlin.de/index.php?title=Badge_Clinic)
- [Design files](https://gitlab.com/tidklaas/hip-badge/)
-
- */