Convert readme to Markdown
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b2686ca
--- /dev/null
+++ b/README.md
@@ -0,0 +1,71 @@
+erlang-bcrypt
+=============
+
+[![Build Status](https://travis-ci.org/erlangpack/bcrypt.svg?branch=master)](https://travis-ci.org/erlangpack/bcrypt)
+[![Hex pm](http://img.shields.io/hexpm/v/bcrypt.svg?style=flat)](https://hex.pm/packages/bcrypt)
+
+erlang-bcrypt is a wrapper around the OpenBSD Blowfish password hashing
+algorithm, as described in
+[A Future-Adaptable Password Scheme](http://www.openbsd.org/papers/bcrypt-paper.ps)
+by Niels Provos and David Mazieres.
+
+Basic build instructions
+------------------------
+
+1. Build it (project uses rebar, but I’ve included a Makefile):
+
+ ```shell
+ make
+ ```
+
+2. Run it (simple way, starting sasl, crypto and bcrypt):
+
+ ```shell
+ erl -pa ebin -boot start_sasl -s crypto -s bcrypt
+ ```
+
+Basic usage instructions
+------------------------
+
+Hash a password using a salt with the default number of rounds:
+
+```erlang
+1> {ok, Salt} = bcrypt:gen_salt().
+{ok,"$2a$12$sSS8Eg.ovVzaHzi1nUHYK."}
+2> {ok, Hash} = bcrypt:hashpw("foo", Salt).
+{ok,"$2a$12$sSS8Eg.ovVzaHzi1nUHYK.HbUIOdlQI0iS22Q5rd5z.JVVYH6sfm6"}
+```
+
+Verify the password:
+
+```erlang
+3> {ok, Hash} =:= bcrypt:hashpw("foo", Hash).
+true
+4> {ok, Hash} =:= bcrypt:hashpw("bar", Hash).
+false
+````
+
+Configuration
+-------------
+
+The bcrypt application is configured by changing values in the
+application's environment:
+
+`default_log_rounds`
+ Sets the default number of rounds which define the complexity of the
+ hash function. Defaults to ``12``.
+
+`mechanism`
+ Specifies whether to use the NIF implementation (`'nif'`) or a
+ pool of port programs (`'port'`). Defaults to `'nif'`.
+
+ `Note: the NIF implementation no longer blocks the Erlang VM
+ scheduler threads`
+
+`pool_size`
+ Specifies the size of the port program pool. Defaults to ``4``.
+
+Original authors
+----------------
+
+Hunter Morris & [Mrinal Wadhwa](https://github.com/mrinalwadhwa).
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 890a271..0000000
--- a/README.rst
+++ /dev/null
@@ -1,72 +0,0 @@
-erlang-bcrypt
-=============
-
-.. image:: https://travis-ci.org/smarkets/erlang-bcrypt.svg?branch=master
- :target: https://travis-ci.org/smarkets/erlang-bcrypt
-
-erlang-bcrypt is a wrapper around the OpenBSD Blowfish password hashing
-algorithm, as described in `"A Future-Adaptable Password Scheme"`_ by Niels
-Provos and David Mazieres.
-
-.. _"A Future-Adaptable Password Scheme":
- http://www.openbsd.org/papers/bcrypt-paper.ps
-
-Basic build instructions
-------------------------
-
-1. Build it (project uses rebar, but I've included a Makefile)::
-
- make
-
-2. Run it (simple way, starting sasl, crypto and bcrypt)::
-
- erl -pa ebin -boot start_sasl -s crypto -s bcrypt
-
-Basic usage instructions
-------------------------
-
-3. Hash a password using a salt with the default number of rounds::
-
- 1> {ok, Salt} = bcrypt:gen_salt().
- {ok,"$2a$12$sSS8Eg.ovVzaHzi1nUHYK."}
- 2> {ok, Hash} = bcrypt:hashpw("foo", Salt).
- {ok,"$2a$12$sSS8Eg.ovVzaHzi1nUHYK.HbUIOdlQI0iS22Q5rd5z.JVVYH6sfm6"}
-
-3. Verify the password::
-
- 3> {ok, Hash} =:= bcrypt:hashpw("foo", Hash).
- true
- 4> {ok, Hash} =:= bcrypt:hashpw("bar", Hash).
- false
-
-Configuration
--------------
-
-The bcrypt application is configured by changing values in the
-application's environment:
-
-``default_log_rounds``
- Sets the default number of rounds which define the complexity of the
- hash function. Defaults to ``12``.
-
-``mechanism``
- Specifies whether to use the NIF implementation (``'nif'``) or a
- pool of port programs (``'port'``). Defaults to ``'nif'``.
-
- `Note: the NIF implementation no longer blocks the Erlang VM
- scheduler threads`
-
-``pool_size``
- Specifies the size of the port program pool. Defaults to ``4``.
-
-Authors
--------
-
-* `Hunter Morris`_
-* `Mrinal Wadhwa`_
-
-.. _Hunter Morris:
- http://github.com/skarab
-
-.. _Mrinal Wadhwa:
- http://github.com/mrinalwadhwa