diff --git a/doc/dwarfs.md b/doc/dwarfs.md
index 27468f30..9ddc5ee4 100644
--- a/doc/dwarfs.md
+++ b/doc/dwarfs.md
@@ -170,7 +170,9 @@ This should be relatively straightforward if you're already familiar
 with adding other FUSE file systems to `/etc/fstab`. An entry looks
 like this:
 
-    dwarfs#/path/to/image.dwarfs /mnt/mountpoint fuse noauto,defaults,user,cachesize=1g 0 0
+```
+dwarfs#/path/to/image.dwarfs /mnt/mountpoint fuse noauto,defaults,user,cachesize=1g 0 0
+```
 
 The first bit before the `#` tells `mount` to look for `mount.dwarfs`,
 which is installed as a symbolic link to the DwarFS FUSE driver. The
diff --git a/doc/mkdwarfs.md b/doc/mkdwarfs.md
index 2ca8a4e9..a5d4fd90 100644
--- a/doc/mkdwarfs.md
+++ b/doc/mkdwarfs.md
@@ -565,12 +565,14 @@ separators.
 Patterns also support character classes.
 
 Here's an example rule set:
+
 ```
 + File/Spec/[EM]*.pm
 - unicore/**.pl
 + *.pl
 - *
 ```
+
 This set of rules will include all files matching `File/Spec/[EM]*.pm`
 anywhere in the hierarchy. It will also include all `*.pl` files, except
 for those anywhere below a `unicore` directory. The last rule excludes