diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c34f9cb514..5e29414280 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -257,6 +257,9 @@ The keyword for the heading must be one of the following:
 - example
 - quote
 
+Do note put [macros](#using-macros) in admonitions,
+as this will likely not give the output you expect.
+
 ## Using macros
 
 We use [mkdocs-macros](https://mkdocs-macros-plugin.readthedocs.io/en/latest/)