diff --git a/README.rst b/README.rst
index 96ae4eb661..db903900c4 100644
--- a/README.rst
+++ b/README.rst
@@ -15,24 +15,23 @@ Global overview
 
 #. Download Android NDK, SDK
  
- * NDK: http://dl.google.com/android/ndk/android-ndk-r8c-linux-x86.tar.bz2
- 
- * More details at: http://developer.android.com/tools/sdk/ndk/index.html
- 
- * SDK: http://dl.google.com/android/android-sdk_r21.0.1-linux.tgz
- 
- * More details at:http://developer.android.com/sdk/index.html
+   * NDK: http://dl.google.com/android/ndk/android-ndk-r8c-linux-x86.tar.bz2
+   * More details at: http://developer.android.com/tools/sdk/ndk/index.html
+   * SDK: http://dl.google.com/android/android-sdk_r21.0.1-linux.tgz
+   * More details at:http://developer.android.com/sdk/index.html
 
 #. Launch "android", and download latest Android platform, here API 14, which would be Android 4.0
 
-#. Export some environment variables::
+#. Export some environment variables:
+
+   .. code-block:: shell
 
-    export ANDROIDSDK="/path/to/android/android-sdk-linux_86"
-    export ANDROIDNDK="/path/to/android/android-ndk-r8c"
-    export ANDROIDNDKVER=r8c
-    export ANDROIDAPI=14
+       export ANDROIDSDK="/path/to/android/android-sdk-linux_86"
+       export ANDROIDNDK="/path/to/android/android-ndk-r8c"
+       export ANDROIDNDKVER=r8c
+       export ANDROIDAPI=14
 
- (Of course correct the paths mentioned in ANDROIDSDK and ANDROIDNDK)
+   (Of course correct the paths mentioned in ANDROIDSDK and ANDROIDNDK)
 
 #. Clone python-for-android::
 
@@ -59,10 +58,10 @@ Global overview
 Troubleshooting
 ---------------
 
-if you get the following message:
+If you get the following message::
 
     Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !
 
-a solution is to remove the "awk" binary in the android ndk distribution
+a solution is to remove the "awk" binary in the android ndk distribution::
 
     rm $ANDROIDNDK/prebuilt/linux-x86/bin/awk