diff --git a/extension/index.rst b/extension/index.md
similarity index 57%
rename from extension/index.rst
rename to extension/index.md
index 52c38a779df08fb635af0ad35aa0f8163a104b3d..e8ea12dd5095e79c2ec6f2df3fb4dce538e28621 100644
--- a/extension/index.rst
+++ b/extension/index.md
@@ -1,21 +1,22 @@
-################
-Extension manual
-################
+# Extension manual
 
 The Jami extension manual is a reference for Jami extension developers, documenting the various aspects of the Jami Extension API and architecture.
 In September 2020, the Jami team added extensions as a call feature for GNU/Linux, Windows, macOS, and Android users.
 This enables personalized call and chat experiences by using available extensions.
 Additionally, anyone is also able to transform awesome ideas into brand new Jami extensions!
 
-**NOTE: Jami source code also uses the term “plugin” to refer to “extension”.**
+```{important}
+Jami source code also uses the term “plugin” to refer to “extension”.
+```
 
-.. toctree::
-   :maxdepth: 1
+```{toctree}
+:maxdepth: 1
 
-   how-it-works
-   how-to-build
-   how-to-publish
-   creating-jami-extensions
-   jami-extension-certificate
-   extension-store-jami-client
-   tensorflow-extension
+how-it-works
+how-to-build
+how-to-publish
+creating-jami-extensions
+jami-extension-certificate
+extension-store-jami-client
+tensorflow-extension
+```
\ No newline at end of file