diff --git a/devices/protocols/Aqara/README.rst b/devices/protocols/Aqara/README.rst
index 4aaccf4a9d9775368d682ae4f1f5adf8f90c45e6..2725c4f7510522efb4fe1bc7ef94b942e9f3cfa3 100644
--- a/devices/protocols/Aqara/README.rst
+++ b/devices/protocols/Aqara/README.rst
@@ -9,20 +9,21 @@ The gateway is able to discover and control most Aqara devices.
 Install & Config
 ----------------
 - Enable local network on the Aqara Gateway with the Mi Home
-  Android or iOS app. You can follow this manual:
-  https://www.domoticz.com/wiki/Xiaomi_Gateway_(Aqara)
-  store the secret key somewhere.
-- Run the xAAL gateway with: python -m xaal.aqara. The gateway
+  Android or iOS app. You can follow this manual: `Domoticz Wiki`_.
+  Search for the key and save it.
+- Run the xAAL gateway with: *python -m xaal.aqara*. The gateway
   should detect all Aqara devices on your local network.
 - To enable quick discovery and control devices (switches, leds..)
-  edit the config file ~/.xaal/xaal.aqara.ini and add the key
+  edit the config file *~/.xaal/aqara.ini* and add the key
   like this:
 
-  [devices]
-    [[xxxxxxxxxxxx]]
-       base_addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx
-       model = gateway
-       secret = ydt5xis45x7k5x1x
+.. code-block:: ini
+
+    [devices]
+        [[xxxxxxxxxxxx]]
+        base_addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx
+        model = gateway
+        secret = ydt5xis45x7k5x1x
 
 
 Notes
@@ -31,3 +32,5 @@ Notes
   network make sure to set a secret key to each hub.
 - xAAL gateway supports most Aqara devices, feel free to edit (and
   submit) xaal/aqara/devices.py if you own a unsupported device.
+
+.. _Domoticz Wiki: https://www.domoticz.com/wiki/Xiaomi_Gateway_(Aqara)