diff --git a/boards/stm32f469i-disco/doc.txt b/boards/stm32f469i-disco/doc.md
similarity index 99%
rename from boards/stm32f469i-disco/doc.txt
rename to boards/stm32f469i-disco/doc.md
index 3041b0bce31e..e0d7b335311e 100644
--- a/boards/stm32f469i-disco/doc.txt
+++ b/boards/stm32f469i-disco/doc.md
@@ -1,4 +1,3 @@
-/**
 @defgroup    boards_stm32f469i-disco STM32F469I-DISCO
 @ingroup     boards
 @brief       Support for the STM32F469I-DISCO board
@@ -116,6 +115,3 @@ make BOARD=stm32f469i-disco PROGRAMMER=cpy2remed flash
 s
 could be found on [this STM webpage](https://www.st.com/en/development-tools/sts
 w-link007.html).
-
-
-*/
diff --git a/boards/stm32l496g-disco/doc.txt b/boards/stm32l496g-disco/doc.md
similarity index 98%
rename from boards/stm32l496g-disco/doc.txt
rename to boards/stm32l496g-disco/doc.md
index d4530b96d957..3af33cca7f4d 100644
--- a/boards/stm32l496g-disco/doc.txt
+++ b/boards/stm32l496g-disco/doc.md
@@ -1,7 +1,6 @@
-/**
- * @defgroup    boards_stm32l496g-disco STM32L496G-DISCO
- * @ingroup     boards
- * @brief       Support for the STM32L496G-DISCO board.
+@defgroup    boards_stm32l496g-disco STM32L496G-DISCO
+@ingroup     boards
+@brief       Support for the STM32L496G-DISCO board.
 
 ## Overview
 
@@ -163,5 +162,3 @@ make BOARD=stm32l496g-disco debug
 For using the STM32L496G-DISCO board we recommend the usage of the
 [GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded)
 toolchain.
-
- */
diff --git a/dist/tools/doccheck/check.sh b/dist/tools/doccheck/check.sh
index 179983907de7..d53d191cae22 100755
--- a/dist/tools/doccheck/check.sh
+++ b/dist/tools/doccheck/check.sh
@@ -73,8 +73,8 @@ exclude_filter() {
 
 # Check groups are correctly defined (e.g. no undefined groups and no group
 # defined multiple times)
-ALL_RAW_DEFGROUP=$(git grep -n @defgroup -- '*.h' '*.hpp' '*.txt' 'makefiles/pseudomodules.inc.mk' 'sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c'| exclude_filter)
-ALL_RAW_INGROUP=$(git grep -n '@ingroup' -- '*.h' '*.hpp' '*.txt' 'makefiles/pseudomodules.inc.mk' 'sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c'| exclude_filter)
+ALL_RAW_DEFGROUP=$(git grep -n @defgroup -- '*.h' '*.hpp' '*.txt' '*/doc.md' 'makefiles/pseudomodules.inc.mk' 'sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c'| exclude_filter)
+ALL_RAW_INGROUP=$(git grep -n '@ingroup' -- '*.h' '*.hpp' '*.txt' '*/doc.md' 'makefiles/pseudomodules.inc.mk' 'sys/net/gnrc/routing/ipv6_auto_subnets/gnrc_ipv6_auto_subnets.c'| exclude_filter)
 DEFINED_GROUPS=$(echo "${ALL_RAW_DEFGROUP}" | \
                     grep -oE '@defgroup[ ]+[^ ]+' | \
                     grep -oE '[^ ]+$' | \
diff --git a/doc/doxygen/riot.doxyfile b/doc/doxygen/riot.doxyfile
index 00a214d116b5..a579d57beb71 100644
--- a/doc/doxygen/riot.doxyfile
+++ b/doc/doxygen/riot.doxyfile
@@ -927,6 +927,7 @@ INPUT_ENCODING         = UTF-8
 # *.ucf, *.qsf and *.ice.
 
 FILE_PATTERNS          = *.txt \
+                         doc.md \
                          *.h \
                          *.h.in \
                          *.hpp