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.