I'm not sure what a mintlify is, but it apparently is very picky.

https://github.com/check-spelling-sandbox/botpress-docs/actions/runs/16948510739/job/48035472465

Error: Syntax error - Unable to parse .github/actions/spelling/advice.md - 1:1-1:86: Expected a closing tag for <details> (1:1-1:10) before the end of paragraph

Nothing about a <details> tag forbids it from containing multiple <p> blocks.

https://html.spec.whatwg.org/multipage/interactive-elements.html#the-details-element

Content model:
One summary element followed by flow content.