diff --git a/modules/wakeonlan/README b/modules/wakeonlan/README
deleted file mode 100644
index 66748da..0000000
--- a/modules/wakeonlan/README
+++ /dev/null
@@ -1,30 +0,0 @@
-This module provides a wrapper around the "wakeonlan" tool available from most
-distributions' package repositories, or from the following website:
-
-http://gsd.di.uminho.pt/jpo/software/wakeonlan/
-
-In order to use this wrapper, create the ~/.wakeonlan directory, and place in
-that directory one file for each device you would like to be able to wake. Give
-the file a name that describes the device, such as its hostname. Each file
-should contain a line with the mac address of the target device and the network
-broadcast address.
-
-For instance, there might be a file ~/.wakeonlan/leto with the following
-contents:
-
-00:11:22:33:44:55:66 192.168.0.255
-
-To wake that device, use the following command:
-
-# wake leto
-
-The available device names will be autocompleted, so:
-
-# wake <tab>
-
-...will suggest "leto", along with any other configuration files that were
-placed in the ~/.wakeonlan directory.
-
-For more information regarding the configuration file format, check the
-wakeonlan man page.
-
diff --git a/modules/wakeonlan/README.md b/modules/wakeonlan/README.md
new file mode 100644
index 0000000..8f73e5b
--- /dev/null
+++ b/modules/wakeonlan/README.md
@@ -0,0 +1,36 @@
+wakeonlan
+=========
+
+This module provides a wrapper around the [wakeonlan][1] tool.
+
+Usage
+-----
+
+To use this wrapper, create the *~/.wakeonlan* directory, and place in it one
+file for each device you would like to be able to wake. Give the file a name
+that describes the device, such as its hostname.
+
+Each file should contain a line with the MAC address of the target device and
+the network broadcast address. For instance, there might be a file
+*~/.wakeonlan/leto* with the following contents:
+
+    00:11:22:33:44:55:66 192.168.0.255
+
+To wake that device, use the following command:
+
+    wake leto
+
+For more information on the configuration file format, read the
+[wakeonlan man page][2].
+
+Authors
+-------
+
+*The authors of this module should be contacted via Github issue tracker.*
+
+ - [Paul Dann](/giddie)
+ - [Sorin Ionescu](/sorin-ionescu)
+
+[1]: http://gsd.di.uminho.pt/jpo/software/wakeonlan/
+[2]: http://man.cx/wakeonlan
+