diff --git a/doc/otter.nvim.txt b/doc/otter.nvim.txt
index 6dc2513..7008aab 100644
--- a/doc/otter.nvim.txt
+++ b/doc/otter.nvim.txt
@@ -43,7 +43,6 @@ Example in a markdown (or quarto markdown) document `index.md`:
 
 >
     # Some markdown
-    
     Hello world
     
     ```python
@@ -59,8 +58,8 @@ We create a hidden buffer for a file `index.md.tmp.py`
      
      
      
-      import numpy as np
-      np.zeros(10)
+    import numpy as np
+    np.zeros(10)
 <
 
 This contains just the python code and blank lines for all other lines (this
@@ -129,6 +128,9 @@ If you want to use the default config below you don’t need to call `setup`.
         write_to_disk = false,
       },
       strip_wrapping_quote_characters = { "'", '"', "`" },
+      -- Otter may not work the way you expect when entire code blocks are indented (eg. in Org files)
+      -- When true, otter handles these cases fully. This is a (minor) performance hit
+      handle_leading_whitespace = false,
     }
 <