diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
index 31988f5e..bcd05e03 100644
--- a/doc/Doxyfile.in
+++ b/doc/Doxyfile.in
@@ -265,7 +265,7 @@ EXTENSION_MAPPING      =
 # can mix doxygen, HTML, and XML commands with Markdown formatting.
 # Disable only in case of backward compatibilities issues.
 
-MARKDOWN_SUPPORT       = NO
+MARKDOWN_SUPPORT       = YES
 
 # If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
 # to include (a tag file for) the STL sources as input, then you should