docs: clarify blank-line rule in admonition multi-line examples (#3468)

* docs: show blank-line rule in admonition multi-line examples

Fix the Plain admonition example so it actually renders multiple
lines, and spell out that paragraphs inside an admonition must be
separated by a blank line.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Update docs/syntax/admonitions.md

Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com>

* docs: address review feedback on admonition examples

- Add an explicit multi-paragraph admonition example (Output + Markdown
  tabs) so the page demonstrates the blank-line paragraph behavior
  instead of only asserting it.
- Keep the intro sentence simple per review (no redundant prose rule);
  remove trailing whitespace introduced earlier.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com>

Author: 3 people

docs/syntax/admonitions.md

@@ -5,6 +5,33 @@ Admonitions allow you to highlight important information with varying levels of
 ## Basic admonitions
 
 Admonitions can span multiple lines and support inline formatting.
+
+:::::{tab-set}
+
+::::{tab-item} Output
+
+:::{admonition} Multiple paragraphs
+Separate paragraphs with a blank line, just like regular Markdown.
+
+Adjacent lines without a blank line between them render as a single paragraph.
+:::
+
+::::
+
+::::{tab-item} Markdown
+
+```markdown
+:::{admonition} Multiple paragraphs
+Separate paragraphs with a blank line, just like regular Markdown.
+
+Adjacent lines without a blank line between them render as a single paragraph.
+:::
+```
+
+::::
+
+:::::
+
 Available admonition types include:
 
 - [Note](#note)
@@ -135,6 +162,8 @@ A plain admonition is a callout with no further styling. Useful to create a call
 ::::{tab-item} Output
 
 :::{admonition} This is my callout
+This is a plain callout.
+
 It can *span* multiple lines and supports inline formatting.
 :::
 
@@ -144,6 +173,8 @@ It can *span* multiple lines and supports inline formatting.
 
 ```markdown
 :::{admonition} This is my callout
+This is a plain callout.
+
 It can *span* multiple lines and supports inline formatting.
 :::
 ```