diff --git a/docs/authoring/markdown-basics.qmd b/docs/authoring/markdown-basics.qmd
index 3c301a4b98..9e802186bd 100644
--- a/docs/authoring/markdown-basics.qmd
+++ b/docs/authoring/markdown-basics.qmd
@@ -353,6 +353,13 @@ Use `$` delimiters for inline math and `$$` delimiters for display math. For exa
 | ```                       |                         |
 +---------------------------+-------------------------+
 
+::: {.callout-note}
+## No blank lines in display math
+
+In display math (`$$`), the delimiters may be separated from the formula by whitespace (`$$ E = mc^{2} $$`).
+However, there can be no blank lines between the opening and closing $$ delimiters.
+:::
+
 If you want to define custom TeX macros, include them within `$$` delimiters enclosed in a `.hidden` block. For example:
 
 ``` tex