diff --git a/docusaurus.config.js b/docusaurus.config.js
index 9a7e3ee0..8ad84db6 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -18,6 +18,7 @@ const config = {
 };
 
 module.exports = {
+  markdown: {format: 'detect'}, // enable mdx syntax only in .mdx files, disable in .md files
   title: 'ClearML',
   tagline: 'Auto-Magical Suite of tools to streamline your AI workflow',
   url: 'https://clear.ml',