diff --git a/docs/reference/formats/html.json b/docs/reference/formats/html.json
index 023be8fb78..334f405198 100644
--- a/docs/reference/formats/html.json
+++ b/docs/reference/formats/html.json
@@ -311,7 +311,7 @@
       },
       {
         "name": "code-block-bg",
-        "description": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n"
+        "description": "Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is\nenabled as well as the color of the background.\n\nFor PDF output, if you specify `false`  and `code-block-border-left` is `false` or not set, the code block is not enclosed in a floating LaTeX environment. This is especially useful for long code blocks nested inside a callout block, as it allows correct page breaks to occur. Line numbering and annotations are not affected.\n"
       },
       {
         "name": "highlight-style",