diff --git a/README.md b/README.md
deleted file mode 100644
index b9c715a..0000000
--- a/README.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# postgres
-
-It sets up [PostgreSQL](http://www.postgresql.org/).
-
-For the best practises see [salt formulas installation and usage instructions](http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html)
-
-## Available states
-
-
-#### ``postgres``
-
-Installs the postgresql package.
-
-#### ``postgres.python``
-
-Installs the postgresql python module
-
-## Testing
-
-Testing is done wit kitchen-salt
-
-#### ``kitchen converge``
-
-Runs the postgres main state
-
-#### ``kitchen verify``
-
-Runs serverspec tests on the actual instance
-
-#### ``kitchen test``
-
-Builds and runs test from scratch
-
-#### ``kitchen login``
-
-Gives you ssh to the vagrant machine for manual testing
-
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..a3077ae
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,50 @@
+========
+postgres
+========
+
+.. note::
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+``postgres``
+------------
+
+Installs the postgresql package.
+
+``postgres.python``
+-------------------
+
+Installs the postgresql python module
+
+Testing
+=======
+
+Testing is done wit kitchen-salt
+
+``kitchen converge``
+--------------------
+
+Runs the postgres main state
+
+``kitchen verify``
+------------------
+
+Runs serverspec tests on the actual instance
+
+``kitchen test``
+----------------
+
+Builds and runs test from scratch
+
+``kitchen login``
+-----------------
+
+Gives you ssh to the vagrant machine for manual testing
+