diff --git a/docs/extensions.rst b/docs/extensions.rst
index 2903a8f4..50185706 100644
--- a/docs/extensions.rst
+++ b/docs/extensions.rst
@@ -38,7 +38,7 @@ don't.
 Compilers
 =========
 
-Compatability
+Compatibility
 
     - Do not use Clang
     - Do not use GCC-LLVM
@@ -73,13 +73,17 @@ To build in development ::
 Pure C
 ======
 
-.. highlight :: c
+.. highlight:: c
+
+::
+
     #include "Python.h"
 
 Releasing the GIL
 =================
 
 ::
+
     from libc.stdio cimport printf
 
     with nogil:
@@ -98,6 +102,8 @@ really the only way.
 Vim
 ===
 
+.. highlight:: vim
+
 For syntax highlighting in Vim::
 
     :set syntax=pyrex