diff --git a/README b/README.md
similarity index 53%
rename from README
rename to README.md
index 301a46a..aa66042 100644
--- a/README
+++ b/README.md
@@ -1,5 +1,10 @@
-BRANCH INFORMATION
-------------------
+# autorandr
+
+Automatically select a display configuration based on connected devices
+
+Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)>
+
+## Branch information
 
 The original wertarbyte/autorandr tree seems unmaintained, with lots of open
 pull requests and issues. I forked it and merged what I thought were the most
@@ -7,56 +12,51 @@ important changes. I will maintain this branch until wertarbyte finds the time
 to maintain his branch again.
 
 
-ORIGINAL README
----------------
-
-
-Tool: "autorandr"
-
-Automatically select a display configuration based on connected devices
-
-Stefan Tomanek <stefan.tomanek@wertarbyte.de>
-
-How to use:
+## How to use
 
 Save your current display configuration and setup with:
- $ autorandr --save mobile
+```
+autorandr --save mobile
+```
 
 Connect an additional display, configure your setup and save it:
- $ autorandr --save docked
+```
+autorandr --save docked
+```
 
 Now autorandr can detect which hardware setup is active:
+```
  $ autorandr
    mobile
    docked (detected)
+```
 
-To automatically reload your setup, just append --change to the command line
+To automatically reload your setup, just append `--change` to the command line
 
-To manually load a profile, you can use the --load <profile> option.
+To manually load a profile, you can use the `--load <profile>` option.
 
 autorandr tries to avoid reloading an identical configuration. To force the
-(re)configuration, apply --force.
+(re)configuration, apply `--force`.
 
-To prevent a profile from being loaded, place a script call "block" in its
+To prevent a profile from being loaded, place a script call _block_ in its
 directory. The script is evaluated before the screen setup is inspected, and
 in case of it returning a value of 0 the profile is skipped. This can be used
 to query the status of a docking station you are about to leave.
 
 If no suitable profile can be identified, the current configuration is kept.
 To change this behaviour and switch to a fallback configuration, specify
---default <profile>
+`--default <profile>`.
 
-Another script called "postswitch "can be placed in the directory
-~/.autorandr as well as in all profile directories: The scripts are executed
+Another script called `postswitch` can be placed in the directory
+`~/.autorandr` as well as in all profile directories: The scripts are executed
 after a mode switch has taken place and can notify window managers or other
 applications about it.
 
+While the script uses xrandr by default, calling it by the name `autodisper`
+or `auto-disper` forces it to use the [disper](http://willem.engen.nl/projects/disper/)
+utility, which is useful for controlling nvidia chipsets. The formats for
+fingerprinting the current setup and saving/loading the current configuration
+are adjusted accordingly.
 
-While the script uses xrandr by default, calling it by the name "autodisper"
-or "auto-disper" forces it to use the "disper" utility, which is useful for
-controlling nvidia chipsets. The formats for fingerprinting the current setup
-and saving/loading the current configuration are adjusted accordingly.
-
-To install autorandr call "make install", define your setup and then call 
-"make hotplug" to install hotplug scripts.
-
+To install autorandr call `make install`, define your setup and then call
+`make hotplug` to install hotplug scripts.