diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
deleted file mode 100644
index c3d61f2..0000000
--- a/src/site/apt/index.apt.vm
+++ /dev/null
@@ -1,150 +0,0 @@
- ------
- Introduction
- ------
- Olivier Lamy
- ------
- 2013-07-24
- ------
-
- ~~ 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
-
-${project.name}
-
- This component provides some utilities to interpret/execute some scripts for various implementations: groovy or beanshell.
-
-* Dependency declaration
-
-+---------
-
- org.apache.maven.shared
- maven-script-interpreter
- ${project.version}
-
-+---------
-
- <<>> has dependency only to core interpreters library,
- all specific extensions should be added in your project.
-
- For example, if you want to use {{{https://docs.groovy-lang.org/latest/html/documentation/grape.html}<>}}
- in a <> script, you must add a dependency to Ivy in your project or in the plugin that will invoke the script:
-
-+---------
-
- org.apache.ivy
- ivy
- ...
-
-+---------
-
-* Using ScriptRunner
-
- <<>> class will detect the script file to run based on supported extensions (<<<.bsh>>>, <<<.groovy>>>).
-
- This class will search in the provided directory the script with the provided fileName and the supported extensions.
-
- See {{{./apidocs/org/apache/maven/shared/scriptinterpreter/ScriptRunner.html}javadoc}} for <<>> methods.
-
-+---------
-try (ScriptRunner scriptRunner = new ScriptRunner()) {
- scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
- new FileLogger(logFile));
-}
-+---------
-
-* Mirror output from script interpreter
-
- In order to do something more with script output, eg. log by your application you must implement <<>>
-
-+---------
-class MyMirrorHandler implements FileLoggerMirrorHandler {
- void consumeOutput(String message) {
- // this method is invoked every time when flush occurs on the underlying stream.
- }
-}
-+---------
-
- Now use it:
-
-+---------
-try (ScriptRunner scriptRunner = new ScriptRunner()) {
- scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
- new FileLogger(logFile, new MyMirrorHandler()));
-}
-+---------
-
-** Global variables
-
- Your scripts will have by default two global variables:
-
- * <<>>: the base directory of your script
-
- * <<>>: the build context (see below)
-
- []
-
- You can add more global variables as it.
-
-+---------
-try (ScriptRunner scriptRunner = new ScriptRunner()) {
- scriptRunner.setGlobalVariable( name, value );
- ...
-}
-+---------
-
-** Build context
-
- You can pass some values to your script using an execution context which have the type << context>>>:
-
-+---------
-private Map buildContext() {
- Map context = new HashMap();
- context.put("foo", "bar");
- return context;
-}
-+---------
-
- Then values are available in scripts context:
-
-+---------
-// in your bsh script
-String value = context.get( "foo" );
-+---------
-
- value will be "bar"
-
-+---------
-// in your Groovy script
-context.get("foo")
-+---------
-
-** Additional classpath entries
-
- You can add some additional classpath entries for your script execution
-
-+---------
-List classpathEntries = list of jar paths
-
-try (ScriptRunner scriptRunner = new ScriptRunner()) {
- scriptRunner.setClassPath( classpathEntries );
- scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
- new FileLogger(logFile));
- }
-+---------
diff --git a/src/site/markdown/index.md.vm b/src/site/markdown/index.md.vm
new file mode 100644
index 0000000..6b57eec
--- /dev/null
+++ b/src/site/markdown/index.md.vm
@@ -0,0 +1,139 @@
+
+
+# ${project.name}
+
+This component provides some utilities to interpret/execute some scripts for various implementations: groovy or beanshell.
+
+Dependency declaration
+----------------------
+
+```unknown
+
+ org.apache.maven.shared
+ maven-script-interpreter
+ ${project.version}
+
+```
+
+`maven-script-interpreter` has dependency only to core interpreters library, all specific extensions should be added in your project.
+
+For example, if you want to use [**Grape**](https://docs.groovy-lang.org/latest/html/documentation/grape.html) in a **Groovy** script, you must add a dependency to Ivy in your project or in the plugin that will invoke the script:
+
+```unknown
+
+ org.apache.ivy
+ ivy
+ ...
+
+```
+
+Using ScriptRunner
+------------------
+
+`ScriptRunner` class will detect the script file to run based on supported extensions (`.bsh`, `.groovy`).
+
+This class will search in the provided directory the script with the provided fileName and the supported extensions.
+
+See [javadoc](./apidocs/org/apache/maven/shared/scriptinterpreter/ScriptRunner.html) for `run(...)` methods.
+
+```unknown
+try (ScriptRunner scriptRunner = new ScriptRunner()) {
+ scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
+ new FileLogger(logFile));
+}
+```
+
+Mirror output from script interpreter
+-------------------------------------
+
+In order to do something more with script output, eg. log by your application you must implement `FileLoggerMirrorHandler`
+
+```unknown
+class MyMirrorHandler implements FileLoggerMirrorHandler {
+ void consumeOutput(String message) {
+ // this method is invoked every time when flush occurs on the underlying stream.
+ }
+}
+```
+
+Now use it:
+
+```unknown
+try (ScriptRunner scriptRunner = new ScriptRunner()) {
+ scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
+ new FileLogger(logFile, new MyMirrorHandler()));
+}
+```
+
+#[[### Global variables]]#
+
+Your scripts will have by default two global variables:
+
+- `basedir`: the base directory of your script
+- `context`: the build context (see below)
+
+You can add more global variables as it.
+
+```unknown
+try (ScriptRunner scriptRunner = new ScriptRunner()) {
+ scriptRunner.setGlobalVariable( name, value );
+ ...
+}
+```
+
+#[[### Build context]]#
+
+You can pass some values to your script using an execution context which have the type `Map context`:
+
+```unknown
+private Map buildContext() {
+ Map context = new HashMap();
+ context.put("foo", "bar");
+ return context;
+}
+```
+
+Then values are available in scripts context:
+
+```unknown
+// in your bsh script
+String value = context.get( "foo" );
+```
+
+value will be "bar"
+
+```unknown
+// in your Groovy script
+context.get("foo")
+```
+
+#[[### Additional classpath entries]]#
+
+You can add some additional classpath entries for your script execution
+
+```unknown
+List classpathEntries = list of jar paths
+
+try (ScriptRunner scriptRunner = new ScriptRunner()) {
+ scriptRunner.setClassPath( classpathEntries );
+ scriptRunner.run("test", new File("src/test/resources/bsh-test"), "verify", buildContext(),
+ new FileLogger(logFile));
+ }
+```