diff --git a/README b/README.md
similarity index 55%
rename from README
rename to README.md
index 5dd6914..b541a69 100644
--- a/README
+++ b/README.md
@@ -1,4 +1,5 @@
 Complete MoinMoin to DokuWiki converter
+=======================================
 
 Uses native MoinMoin modules to handle converting and translating paths.
 Converts also page history and edit-log.
@@ -13,29 +14,42 @@ it uses current configuration from both wikis.
 Edit doku.php if your DokuWiki installation is other than /usr/share/dokuwiki
 
 To convert moinmoin all pages with history, invoke:
+```
 $ ./moin2doku.py -a -d /var/lib/dokuwiki
+```
 
 To convert single page (FrontPage):
+```
 $ ./moin2doku.py -F moinmoin/data/pages/FrontPage -d out
+```
 
-You should invoke bin/indexer.php after conversion to make all pages are indexed.
+You should invoke `bin/indexer.php` after conversion to make all pages are indexed.
 
 and ensure ownership of files is correct:
-(www-data:www-data being your uid/gid webserver runs):
+(`www-data:www-data` being your uid/gid webserver runs):
+```
 # chown -R www-data:www-data /var/lib/dokuwiki/pages/*
 # chown -R www-data:www-data /var/lib/dokuwiki/media/*
-
+```
 additionally, depending on your configuration, you may need to gzip the attic pages.
 
-History:
-version 0.1  2010-02
-  Slim Gaillard, based on the "extended python" convert.py script here:
-  https://www.dokuwiki.org/tips:moinmoin2doku?rev=1297006559#extended_python
+History
+=======
 
-version 0.2  2011
-  Elan Ruusamäe, moved to github, track history there
-  https://github.com/glensc/moin2doku
+version 0.1 (2010-02)
+-------------------
 
-version 1.0  2012
-  Complete moinmoin to dokuwiki converter, uses native moinmoin code to handle
-  converting and translating paths. Converts also page history and edit-log.
+Slim Gaillard, based on the "extended python" convert.py script here:
+https://www.dokuwiki.org/tips:moinmoin2doku?rev=1297006559#extended_python
+
+version 0.2 (2011)
+----------------
+
+Elan Ruusamäe, moved to github, track history there
+https://github.com/glensc/moin2doku
+
+version 1.0 (2012)
+----------------
+
+Complete moinmoin to dokuwiki converter, uses native moinmoin code to handle
+converting and translating paths. Converts also page history and edit-log.