It is semantically more correct and improves compatibility with external tools (IDEs, formatters, linters, etc.). In future versions of Docusaurus, .md files will be parsed as standard CommonMark, which does not support these features. In Docusaurus v3, .md files keep being compiled as MDX files, but it will be possible to opt-in for CommonMark.
We must not only rename the files but also update all references to them.
https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3#preparatory-work
We must not only rename the files but also update all references to them.
https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3#preparatory-work