diff --git a/docs/index.rst b/docs/index.rst
index 652b51b..ca2cfb1 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -5,7 +5,7 @@ vdirsyncer
 vdirsyncer synchronizes your calendars and addressbooks between two storages.
 The supported storages are CalDAV, CardDAV, arbitrary HTTP resources, `vdir
 <https://github.com/untitaker/vdir>`_ and some more. The documentation contains
-a full `list of supported storages <storages>`.
+a full :doc:`list of supported storages <storages>`.
 
 It aims to be for CalDAV and CardDAV what `OfflineIMAP
 <http://offlineimap.org/>`_ is for IMAP.
@@ -20,7 +20,7 @@ As all Python packages, vdirsyncer can be installed with ``pip``::
     pip install --user vdirsyncer
 
 Then copy ``example.cfg`` to ``~/.vdirsyncer/config`` and edit it. You can use the
-`VDIRSYNCER_CONFIG` environment variable to change the path vdirsyncer will
+``VDIRSYNCER_CONFIG`` environment variable to change the path vdirsyncer will
 read the config from.
 
 Run ``vdirsyncer --help`` and read on: