diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index 32218fc67..9ad86d5e2 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -100,17 +100,17 @@ Backup compression
 Default is no compression, but we support different methods with high speed
 or high compression:
 
-If you have a quick repo storage and you want a little compression:
+If you have a quick repo storage and you want a little compression: ::
 
     $ borg create --compression lz4 /mnt/backup::repo ~
 
 If you have a medium fast repo storage and you want a bit more compression (N=0..9,
-0 means no compression, 9 means high compression):
+0 means no compression, 9 means high compression): ::
 
     $ borg create --compression zlib,N /mnt/backup::repo ~
 
 If you have a very slow repo storage and you want high compression (N=0..9, 0 means
-low compression, 9 means high compression):
+low compression, 9 means high compression): ::
 
     $ borg create --compression lzma,N /mnt/backup::repo ~
 
diff --git a/docs/usage.rst b/docs/usage.rst
index 80f3eaa2f..efad02b5d 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -418,15 +418,14 @@ original volumes continue changing the data stored there.
 You also add the output of `lvdisplay` to your backup, so you can see the LV sizes
 in case you ever need to recreate and restore them.
 
-After the backup has completed, you remove the snapshots again.
+After the backup has completed, you remove the snapshots again. ::
 
-::
     $ # create snapshots here
     $ lvdisplay > lvdisplay.txt
     $ borg create --read-special /mnt/backup::repo lvdisplay.txt /dev/vg0/*-snapshot
     $ # remove snapshots here
 
-Now, let's see how to restore some LVs from such a backup.
+Now, let's see how to restore some LVs from such a backup. ::
 
     $ borg extract /mnt/backup::repo lvdisplay.txt
     $ # create empty LVs with correct sizes here (look into lvdisplay.txt).