diff --git a/microsite/docusaurus.config.js b/microsite/docusaurus.config.js
index b4bcf2f3ac..227f475a44 100644
--- a/microsite/docusaurus.config.js
+++ b/microsite/docusaurus.config.js
@@ -70,6 +70,7 @@ module.exports = {
   ],
   markdown: {
     preprocessor({ fileContent }) {
+      // Remove HTML comments from markdown files as they're not supported by MDX2
       return fileContent.replace(/<!--.*?-->/gs, '');
     }
   },