diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
deleted file mode 100644
index 76f890b1f..000000000
--- a/src/site/apt/index.apt
+++ /dev/null
@@ -1,55 +0,0 @@
- ------
- Plexus Compiler
- ------
- Hervé Boutemy
- ------
- 2012-05-08
- ------
-
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-Plexus Compiler
-
-  Plexus Compiler is a Plexus component to use different compilers through a uniform API.
-
-  It is composed by:
-
-  * {{{./plexus-compiler-api/}<<<plexus-compiler-api>>>}}: the API to use compilers,
-
-  * {{{./plexus-compiler-manager/}<<<plexus-compiler-manager>>>}}: a manager to choose a compiler,
-
-  * {{{./plexus-compilers/}<<<plexus-compilers>>>}}: different compilers
-
-    * {{{./plexus-compilers/plexus-compiler-aspectj/}<<<plexus-compiler-aspectj>>>}}: AspectJ compiler, <<requires>> <<<JDK 17+>>> and <<<Maven 3.9.6+>>>
-
-    * {{{./plexus-compilers/plexus-compiler-csharp/}<<<plexus-compiler-csharp>>>}}: C#/Mono compiler, <<requires>> <<<JDK 8+>>>
-
-    * {{{./plexus-compilers/plexus-compiler-eclipse/}<<<plexus-compiler-eclipse>>>}}: Eclipse compiler, <<requires>> <<<JDK 17+>>> and <<<Maven 3.9.6+>>>
-
-    * {{{./plexus-compilers/plexus-compiler-javac/}<<<plexus-compiler-javac>>>}}: javac compiler, <<requires>> <<<JDK 8+>>>
-
-    * {{{./plexus-compilers/plexus-compiler-javac-errorprone/}<<<plexus-compiler-javac-errorprone>>>}}: javac compiler with {{{https://errorprone.info}error-prone}} static analysis checks enabled, <<requires>> <<<JDK 11+>>>
-
-    []
-
-  * {{{./plexus-compiler-test/}<<<plexus-compiler-test>>>}}: a test harness.
-
-  []
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
new file mode 100644
index 000000000..85796bcb9
--- /dev/null
+++ b/src/site/markdown/index.md
@@ -0,0 +1,34 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Plexus Compiler
+
+Plexus Compiler is a Plexus component to use different compilers through a uniform API.
+
+It is composed by:
+
+- [`plexus-compiler-api`](./plexus-compiler-api/): the API to use compilers,
+- [`plexus-compiler-manager`](./plexus-compiler-manager/): a manager to choose a compiler,
+- [`plexus-compilers`](./plexus-compilers/): different compilers
+    - [`plexus-compiler-aspectj`](./plexus-compilers/plexus-compiler-aspectj/): AspectJ compiler, **requires** `JDK 17+` and `Maven 3.9.6+`
+    - [`plexus-compiler-csharp`](./plexus-compilers/plexus-compiler-csharp/): C#/Mono compiler, **requires** `JDK 8+`
+    - [`plexus-compiler-eclipse`](./plexus-compilers/plexus-compiler-eclipse/): Eclipse compiler, **requires** `JDK 17+` and `Maven 3.9.6+`
+    - [`plexus-compiler-javac`](./plexus-compilers/plexus-compiler-javac/): javac compiler, **requires** `JDK 8+`
+    - [`plexus-compiler-javac-errorprone`](./plexus-compilers/plexus-compiler-javac-errorprone/): javac compiler with [error-prone](https://errorprone.info) static analysis checks enabled, **requires** `JDK 11+`
+- [`plexus-compiler-test`](./plexus-compiler-test/): a test harness.