diff --git a/src/site/apt/examples/unlock-snapshots.apt b/src/site/apt/examples/unlock-snapshots.apt
deleted file mode 100644
index d3e83b1848..0000000000
--- a/src/site/apt/examples/unlock-snapshots.apt
+++ /dev/null
@@ -1,104 +0,0 @@
- ~~ 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.
-
- -----
- Unlocking snapshot dependencies
- -----
- Stephen Connolly, Paul Gier
- ------
- 2009-04-20
- ------
-
-Unlocking snapshot dependencies
-
- If your pom contains a lot of -SNAPSHOT dependencies and those -SNAPSHOT dependencies are a moving target, it
- can sometimes be helpful to temporarily replace the -SNAPSHOT with a locked -YYYYMMDD.HHMMSS-NNN snapshot.
- In the long term, you will need to return to the -SNAPSHOT dependencies and then replace them with their
- release version, but if you need a short term semi-reproducible build, locked -SNAPSHOTs can sometimes be a
- useful hack.
-
- If your pom has specified locked snapshot versions (these will end with the form -YYYYMMDD.HHMMSS-NNN) for certain
- ependencies:
-
-+---+
-
-
-
- org.codehaus.cargo
- cargo-core-api
- 1.0-20081117.213112-16
-
-
-
-+---+
-
- Using the <<>> goal, the locked snapshot versions can be unlocked again to regular -SNAPSHOT
- versions.
-
----
-mvn versions:unlock-snapshots
----
-
- The pom dependencies are modified to look like the following.
-
-+---+
-
-
-
- org.codehaus.cargo
- cargo-core-api
- 1.0-SNAPSHOT
-
-
-
-+---+
-
- You can restrict which dependencies should have their -SNAPSHOT versions unlocked. For example,
- the following will only match dependencies that match the groupId "org.codehaus.plexus" and artifactId
- "plexus-utils"
-
----
-mvn versions:unlock-snapshots -Dincludes=org.codehaus.plexus:plexus-utils
----
-
- The <<>> and <<>> parameters follow the format <<>>.
- Use a comma separated separated list to specify multiple includes. Wildcards (*) can also be used to match
- multiple values.
-
- This example will match anything with the groupId "org.codehaus.plexus" and anything with the groupId and
- artifactId matching "junit".
-
----
-mvn versions:unlock-snapshots -Dincludes=org.codehaus.plexus:*,junit:junit
----
-
- By default, both the <<>> and <<>> sections will be processed.
- You can use the <<>> and <<>> parameters to control which sections
- are processed.
-
- This example will only process the <<>> section of your pom:
-
----
-mvn versions:unlock-snapshots -DprocessDependencies=false
----
-
- While this example will only process the <<>> section of your pom:
-
----
-mvn versions:unlock-snapshots -DprocessDependencyManagement=false
----
-
diff --git a/src/site/markdown/examples/unlock-snapshots.md b/src/site/markdown/examples/unlock-snapshots.md
new file mode 100644
index 0000000000..1f65e0e5b4
--- /dev/null
+++ b/src/site/markdown/examples/unlock-snapshots.md
@@ -0,0 +1,99 @@
+title: Unlocking snapshot dependencies
+author: Stephen Connolly, Paul Gier
+date: 2009-04-20
+
+
+
+# Unlocking snapshot dependencies
+
+If your pom contains a lot of -SNAPSHOT dependencies and those -SNAPSHOT dependencies are a moving target, it
+can sometimes be helpful to temporarily replace the -SNAPSHOT with a locked -YYYYMMDD.HHMMSS-NNN snapshot.
+In the long term, you will need to return to the -SNAPSHOT dependencies and then replace them with their
+release version, but if you need a short term semi-reproducible build, locked -SNAPSHOTs can sometimes be a
+useful hack.
+
+If your pom has specified locked snapshot versions (these will end with the form -YYYYMMDD.HHMMSS-NNN) for certain
+ependencies:
+
+```xml
+
+
+
+ org.codehaus.cargo
+ cargo-core-api
+ 1.0-20081117.213112-16
+
+
+
+```
+
+Using the `unlock-snapshots` goal, the locked snapshot versions can be unlocked again to regular -SNAPSHOT
+versions.
+
+```shell
+mvn versions:unlock-snapshots
+```
+
+The pom dependencies are modified to look like the following.
+
+```xml
+
+
+
+ org.codehaus.cargo
+ cargo-core-api
+ 1.0-SNAPSHOT
+
+
+
+```
+
+You can restrict which dependencies should have their -SNAPSHOT versions unlocked. For example,
+the following will only match dependencies that match the groupId "org.codehaus.plexus" and artifactId
+"plexus-utils"
+
+```shell
+mvn versions:unlock-snapshots -Dincludes=org.codehaus.plexus:plexus-utils
+```
+
+The `includes` and `excludes` parameters follow the format `groupId:artifactId:type:classifier`.
+Use a comma separated separated list to specify multiple includes. Wildcards (*) can also be used to match
+multiple values.
+
+This example will match anything with the groupId "org.codehaus.plexus" and anything with the groupId and
+artifactId matching "junit".
+
+```shell
+mvn versions:unlock-snapshots -Dincludes=org.codehaus.plexus:*,junit:junit
+```
+
+By default, both the `project/dependencyManagment` and `project/dependencies` sections will be processed.
+You can use the `processDependencies` and `processDependencyManagement` parameters to control which sections
+are processed.
+
+This example will only process the `project/dependencyManagment` section of your pom:
+
+```shell
+mvn versions:unlock-snapshots -DprocessDependencies=false
+```
+
+While this example will only process the `project/dependencies` section of your pom:
+
+```shell
+mvn versions:unlock-snapshots -DprocessDependencyManagement=false
+```