Greptile Summary

This PR fixes a long-standing CSS layout bug (#2796) where .katex-mathml (an accessibility-only, position: absolute element) was incorrectly positioned relative to a distant ancestor rather than its .katex parent, causing unexpected whitespace to accumulate at the bottom of pages with many KaTeX-rendered elements.

Key changes:

• Adds position: relative to .katex in src/styles/katex.scss, making it a proper containing block for its absolutely-positioned .katex-mathml child.

Impact:

• The fix is minimal and surgical — a single CSS property on the top-level .katex class.
• .katex-mathml is a screen-reader-only element (1px × 1px, clipped, overflow: hidden) so there is no visual change to rendered math — only the layout displacement is corrected.
• No JavaScript or rendering logic is touched.
• No new stacking context is created (no z-index is set alongside position: relative), so existing layering behaviour is preserved.

Confidence Score: 5/5

• This PR is safe to merge — it is a one-line, well-understood CSS fix with no side-effects on visual rendering or JavaScript behaviour.
• The change is a single CSS property (position: relative) on a well-understood selector. The root cause (a missing positioned ancestor for an position: absolute child) is clearly documented in the issue, the fix is the canonical solution, and no other styling or logic is affected.
• No files require special attention.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    subgraph Before["Before (Bug)"]
        A1["nearest positioned ancestor\n(position: relative/absolute/fixed)"] -->|".katex-mathml positioned\nrelative to this"| B1[".katex\n(position: static — default)"]
        B1 --> C1[".katex-mathml\n(position: absolute)\n⚠️ escapes .katex container"]
        B1 --> D1[".katex-html\n(visible math)"]
    end

    subgraph After["After (Fix)"]
        A2["nearest positioned ancestor"] --> B2[".katex\n(position: relative) ✅"]
        B2 -->|".katex-mathml now\ncontained here"| C2[".katex-mathml\n(position: absolute)\n✅ correctly clipped inside .katex"]
        B2 --> D2[".katex-html\n(visible math)"]
    end

_{Last reviewed commit: "fix(css): specify po..."}

I checked #3970 (comment) and haven't seen any issues with \sqrt. It's also wrapped in position: relative by immediate parent, so it looks safe.

Thank you!

🎉 This PR is included in version 0.16.40 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀