diff --git a/docs/conf.py b/docs/conf.py
index 4ad48b4..030c354 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -30,7 +30,6 @@
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
-    "recommonmark",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -38,7 +37,6 @@
 
 source_suffix = {
     ".rst": "restructuredtext",
-    ".md": "markdown",
 }
 
 # List of patterns, relative to source directory, that match files and
diff --git a/docs/examples.md b/docs/examples.md
deleted file mode 100644
index c01d434..0000000
--- a/docs/examples.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# Examples
-
-## Finding devices
-
-List all info of all devices with:
-
-```python
-import hid
-
-for device_dict in hid.enumerate():
-    keys = list(device_dict.keys())
-    keys.sort()
-    for key in keys:
-        print("%s : %s" % (key, device_dict[key]))
-    print()
-
-```
-
-## Connecting, reading and writing
-
-```python
-try:
-    print("Opening the device")
-
-    h = hid.device()
-    h.open(0x534C, 0x0001)  # TREZOR VendorID/ProductID
-
-    print("Manufacturer: %s" % h.get_manufacturer_string())
-    print("Product: %s" % h.get_product_string())
-    print("Serial No: %s" % h.get_serial_number_string())
-
-    # enable non-blocking mode
-    h.set_nonblocking(1)
-
-    # write some data to the device
-    print("Write the data")
-    h.write([0, 63, 35, 35] + [0] * 61)
-
-    # wait
-    time.sleep(0.05)
-
-    # read back the answer
-    print("Read the data")
-    while True:
-        d = h.read(64)
-        if d:
-            print(d)
-        else:
-            break
-
-    print("Closing the device")
-    h.close()
-
-except IOError as ex:
-    print(ex)
-    print("You probably don't have the hard-coded device.")
-    print("Update the h.open() line in this script with the one")
-    print("from the enumeration list output above and try again.")
-
-print("Done")
-```
diff --git a/docs/examples.rst b/docs/examples.rst
new file mode 100644
index 0000000..7558890
--- /dev/null
+++ b/docs/examples.rst
@@ -0,0 +1,64 @@
+Examples
+========
+
+Finding devices
+---------------
+
+List all info of all devices with:
+
+.. code-block:: python
+
+    import hid
+
+    for device_dict in hid.enumerate():
+        keys = list(device_dict.keys())
+        keys.sort()
+        for key in keys:
+            print("%s : %s" % (key, device_dict[key]))
+        print()
+
+
+Connecting, reading and writing
+-------------------------------
+
+.. code-block:: python
+
+    try:
+        print("Opening the device")
+
+        h = hid.device()
+        h.open(0x534C, 0x0001)  # TREZOR VendorID/ProductID
+
+        print("Manufacturer: %s" % h.get_manufacturer_string())
+        print("Product: %s" % h.get_product_string())
+        print("Serial No: %s" % h.get_serial_number_string())
+
+        # enable non-blocking mode
+        h.set_nonblocking(1)
+
+        # write some data to the device
+        print("Write the data")
+        h.write([0, 63, 35, 35] + [0] * 61)
+
+        # wait
+        time.sleep(0.05)
+
+        # read back the answer
+        print("Read the data")
+        while True:
+            d = h.read(64)
+            if d:
+                print(d)
+            else:
+                break
+
+        print("Closing the device")
+        h.close()
+
+    except IOError as ex:
+        print(ex)
+        print("You probably don't have the hard-coded device.")
+        print("Update the h.open() line in this script with the one")
+        print("from the enumeration list output above and try again.")
+
+    print("Done")
diff --git a/docs/index.rst b/docs/index.rst
index e8c2e03..ad94090 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -11,7 +11,7 @@ Welcome to HIDAPI's documentation!
    :caption: Contents:
 
    Home <self>
-   examples.md
+   examples.rst
    api.rst