diff --git a/README.adoc b/README.adoc
index 5f05d0b..7b18a12 100644
--- a/README.adoc
+++ b/README.adoc
@@ -355,7 +355,7 @@ default:
 The heading text can be customized with `--list-heading`:
 
 ```
-$ just --list --list-heading 'Cool stuff…\n'
+$ just --list --list-heading $'Cool stuff…\n'
 Cool stuff…
     test
     build
@@ -370,6 +370,16 @@ Available recipes:
 ····build
 ```
 
+The argument to `--list-heading` replaces both the heading and the newline
+following it, so it should contain a newline if non-empty. It works this way so
+you can suppress the heading line entirely by passing the empty string:
+
+```
+$ just --list --list-heading ''
+    test
+    build
+```
+
 === Aliases
 
 Aliases allow recipes to be invoked with alternative names: