docfixes
diff --git a/README.rst b/README.rst
index 4e914ed..55c13f8 100644
--- a/README.rst
+++ b/README.rst
@@ -1,9 +1,15 @@
 
-# rsync
+=============
+rsync Formula
+=============
 
-rsync is an open source utility that provides fast incremental file transfer. 
+rsync is an open source utility that provides fast incremental file transfer.
 
-## Sample pillar
+
+Sample Metadata
+===============
+
+.. code-block:: yaml
 
     rsync:
       server:
@@ -17,11 +23,14 @@
             read_only: False
         timeout: 300
 
-## Read more
+
+References
+==========
 
 * http://rsync.samba.org/
 * http://www.togaware.com/linux/survivor/Rsync_Server.html
 
+
 Documentation and Bugs
 ======================