diff --git a/README.rst b/README.rst
index 4299b72a910ba2673af0f30ff6f1fcaeb1eb2393..ecd23752276e4560605006f5e3d8c59f148a2a0a 100644
--- a/README.rst
+++ b/README.rst
@@ -11,14 +11,14 @@ It currently only supports OXR's "historical" API.
 Getting started with the CLI tool
 ---------------------------------
 
-oxrlib includes an `oxrquery` tool to access the OXR API directly from the command line.  By default, it reads your OXR credentials and other common configuration from `~/.config/oxrlib.ini`.  Copy `oxrlib_example.ini` from the source to `~/.config/oxrlib.ini`, then edit that file following the instructions in the comments.
+oxrlib includes an ``oxrquery`` tool to access the OXR API directly from the command line.  By default, it reads your OXR credentials and other common configuration from ``~/.config/oxrlib.ini``.  Copy ``oxrlib_example.ini`` from the source to ``~/.config/oxrlib.ini``, then edit that file following the instructions in the comments.
 
-Run `oxrquery --help` for instructions to use the tool.
+Run ``oxrquery --help`` for instructions to use the tool.
 
 Getting started with the library
 --------------------------------
 
-Here's an example of using the Python library, complete with caching results:
+Here's an example of using the Python library, complete with caching results::
 
   from oxrlib import cache, loaders, rate
 
@@ -36,4 +36,4 @@ Here's an example of using the Python library, complete with caching results:
 Running tests
 -------------
 
-Run `./setup.py test` from your checkout directory.
+Run ``./setup.py test`` from your checkout directory.