diff --git a/README b/README
deleted file mode 100644
index b6fadc6..0000000
--- a/README
+++ /dev/null
@@ -1,14 +0,0 @@
-Add a task to taskwarrior via email. Makes use of the taskw Python bindings.
-
- http://taskwarrior.org
- https://github.com/ralphbean/taskw
-
-For use with procmail or maildrop. Example using maildrop's .mailfilter:
-
-
-  if ($SIZE < 8192 && /^From:.*myaddress@example.com/ && /^To:.*taskwarrior@/)
-  {
-    log "add task via mail2taskwarrior"
-    xfilter "devel/mail2taskwarrior/mail2taskwarrior"
-    exit
-  }
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8fc3e61
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+Add a task to [taskwarrior](http://taskwarrior.org) via email. Makes use of the
+[taskw](https://github.com/ralphbean/taskw) Python bindings.
+
+
+For use with procmail or maildrop. Example using maildrop's `.mailfilter`:
+
+~~~
+if ($SIZE < 8192 && /^From:.*myaddress@example.com/ && /^To:.*taskwarrior@/)
+{
+  log "add task via mail2taskwarrior"
+  xfilter "devel/mail2taskwarrior/mail2taskwarrior"
+  exit
+}
+~~~