Motivation

Rapira supports ::: question blocks and can collect them into collapsible FAQ sections at configurable heading levels. YiiPress currently requires authors to hand-write FAQ markup and offers no grouping behavior.

Reference: https://rapira.rs/docs/contributing#questions-faq-spoilers

Proposed behavior

Support titled question blocks with a per-entry grouping level. Questions may stay inline, collect at the page end, or collect at the end of matching heading sections.

Acceptance criteria

• Parse a question title and Markdown answer safely.
• Support inline mode, page-end grouping, and validated heading-level grouping.
• Render semantic details/summary markup that works without JavaScript.
• Preserve document order and handle multiple sections predictably.
• Consider emitting FAQPage structured data without duplicating visible content.
• Add PHPUnit coverage, documentation, and a phpbench benchmark for pages with many questions.