1 files changed, 6 insertions, 0 deletions

diff --git a/src/lib.rs b/src/lib.rs
index bc235c3..3e3407a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -493,6 +493,9 @@ pub struct Constructs {
     ///     ^^^^^^^^^^^^^
     /// ```
     ///
+    /// > 👉 **Note**: You *must* pass `html_flow: false` to use this,
+    /// > as it’s preferred when on over `mdx_jsx_flow`.
+    ///
     /// > 👉 **Note**: You *can* pass
     /// > [`mdx_expression_parse`][MdxExpressionParse] in [`ParseOptions`][]
     /// > too, to parse expressions in JSX according to a certain grammar
@@ -507,6 +510,9 @@ pub struct Constructs {
     ///       ^^^^^^^^^^^^^
     /// ```
     ///
+    /// > 👉 **Note**: You *must* pass `html_text: false` to use this,
+    /// > as it’s preferred when on over `mdx_jsx_text`.
+    ///
     /// > 👉 **Note**: You *can* pass
     /// > [`mdx_expression_parse`][MdxExpressionParse] in [`ParseOptions`][]
     /// > too, to parse expressions in JSX according to a certain grammar