diff --git a/hgext/acl.py b/hgext/acl.py
--- a/hgext/acl.py
+++ b/hgext/acl.py
@@ -21,7 +21,7 @@ hook is not safe to use if users have in
 then disable the hook. Nor is it safe if remote users share an account,
 because then there is no way to distinguish them.
 
-To use this hook, configure the acl extension in your hgrc like this:
+To use this hook, configure the acl extension in your hgrc like this::
 
   [extensions]
   hgext.acl =
@@ -36,7 +36,7 @@ To use this hook, configure the acl exte
 
 The allow and deny sections take a subtree pattern as key (with a glob syntax
 by default), and a comma separated list of users as the corresponding value.
-The deny list is checked before the allow list is.
+The deny list is checked before the allow list is. ::
 
   [acl.allow]
   # If acl.allow is not present, all users are allowed by default.