diff --git a/apps/manage/README.md b/apps/manage/README.md
new file mode 100644
index 00000000..81d4eaa6
--- /dev/null
+++ b/apps/manage/README.md
@@ -0,0 +1,26 @@
+To get the manage application to work you need to
+
+- add it to the `apps.properties` file with the following line:
+
+```
+manage
+````
+
+- use a Helma distribution version 1.5 or higher.
+
+- add the following properties to the `server.properties` file:
+ 
+```
+allowAdmin = [comma-separated list of hosts or ip-addresses that
+              are allowed to access this application. wildcards
+              are only allowed in addresses, not in hostnames!]
+adminAccess = <MD5-encoded credentials>
+```
+
+Creating the credentials can be done after you've got the application
+up and running at this address:
+
+```
+http://<your-server-name>/manage/makekey
+```
+
diff --git a/apps/manage/readme.txt b/apps/manage/readme.txt
deleted file mode 100644
index 8e271c95..00000000
--- a/apps/manage/readme.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-To get the manage-application to work you must:
-
- - add it to the apps.properties file with the following line:
-     manage
-
- - use helma distribution 1.5 or later.
-
- - add the following properties to server.properties:
- 
-   allowAdmin = [comma-separated list of hosts or ip-addresses that
-                 are allowed to access this application. wildcards
-                 are only allowed in addresses, not in hostnames!]
-   adminAccess = <MD5-encoded credentials>
-   
-   Creating the credentials can be done after you've got the application
-   up and running at this address: http://<your-server-name>/manage/makekey
-