From d68f5431c2393377e6cdc209ee49fd1c68a21f08 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Canouil?=
 <8896044+mcanouil@users.noreply.github.com>
Date: Fri, 2 May 2025 23:18:28 +0200
Subject: [PATCH] docs(markdown-basics.qmd): add display math requirement

---
 docs/authoring/markdown-basics.qmd | 7 +++++++
 1 file changed, 7 insertions(+)

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