Document client-side evaluation of MDX expressions

[mintlify]

Documentation changes

Adds a note to the reusable snippets page explaining that MDX expressions and imported variables are evaluated in the browser, so their computed values are absent from pre-hydration HTML and offline exports. Non-JS consumers (crawlers, LLM ingestion) see the surrounding text without the values. Prompted by a customer report reproducing this in mint export and mint dev across 13 expression forms.

Closes

---

For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

• Code examples work as written
• Commands and configurations are correct
• Links resolve to the right destinations
• Prerequisites and requirements are accurate

✅ Clarity and completeness

• Instructions are clear and easy to follow
• Steps are in logical order
• Nothing important is missing
• Examples help illustrate the concepts

✅ User experience

• A new user could follow these docs successfully
• Common gotchas or edge cases are addressed
• Error messages or troubleshooting guidance is helpful

---

Generated by Mintlify Agent.

Requested by: demarcus@mintlify.com via Slack
Mintlify session: slack_1788189297.206459_D0B7MV5PAA3

---

Note

Low Risk
Documentation-only change with no runtime or product behavior impact.

Overview
Adds a Note on the reusable snippets page, immediately after the Import variables walkthrough, clarifying that MDX expressions (imported variables and inline expressions like {1 + 1}) are evaluated in the browser.

The note explains that computed values are missing from initial HTML and from offline exports, so crawlers, LLMs, and other non-JS consumers only see the surrounding text. It advises using plain text when values must be visible without JavaScript.

^{Reviewed by Cursor Bugbot for commit 8e55d00. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Sep 11, 2026, 5:33 PM