diff --git a/040-Data-operations/120-aggregate.mdx b/040-Data-operations/120-aggregate.mdx
index e6597c3a..e0612fac 100644
--- a/040-Data-operations/120-aggregate.mdx
+++ b/040-Data-operations/120-aggregate.mdx
@@ -217,7 +217,11 @@ There are two types of aggregations:
 - _bucket aggregations_, which split the data into buckets based on a column value. Examples of bucket aggregations are: `topValues`, `dateHistogram` and `numericHistogram`.
 - _metric aggregations_, which compute a value based on the data in the bucket. Examples of metric aggregations are: `average`, `sum`, `min`, `max`, `count` and `uniqueCount`.
 
-<Alert status="warning">Aggregations cannot be used with [link](/docs/concepts/data-model#link) columns.</Alert>
+<Alert status="warning">
+
+Aggregations cannot be used with [link](/docs/concepts/data-model#link) columns.
+
+</Alert>
 
 ## Response type
 
diff --git a/readme.md b/readme.md
index c5fc7c03..9747b54f 100644
--- a/readme.md
+++ b/readme.md
@@ -41,7 +41,7 @@ The following are extra components that can be used within the markdown files.
 
 #### Alerts
 
-Alerts accept a `status` prop with values of `info | warning | danger`
+Alerts accept a `status` prop with values of `info | warning | danger`.
 
 ```tsx
 <Alert status="warning">
@@ -50,6 +50,16 @@ Alerts accept a `status` prop with values of `info | warning | danger`
 </Alert>
 ```
 
+This component assumes your alert is simple and is a simple string (which is good practice). However, if you need multiple lines or other markdown (like links or images) you might need to include extra whitespace for proper rendering:
+
+```
+<Alert status="warning">
+
+Aggregations cannot be used with [link](/docs/concepts/data-model#link) columns.
+
+</Alert>
+```
+
 #### Images
 
 Images using typical markdown syntax will transform into ones that will work with the Next JS / Vercel pipeline. Images can exist anywhere within this repo, but should be relative to the document they are referenced in