`WARNING: Transition must be child of <document> or <section>. [docutils]`

[amotl]

What version of myst-parser are you using?

5.0.0

What version dependencies are you using?

sphinx: 9.1.0
docutils: 0.22.4

What operating system are you using?

Mac

Describe the Bug

Problem

When using a transition inside a fenced block, the parser fails. We think it only started happening with recent versions of the stack.

WARNING: Transition must be child of <document> or <section>. [docutils]

-- https://github.com/crate/cloud-docs/actions/runs/21460158588/job/61810516343?pr=117#step:4:666

Because our documentation builds are configured to treat warnings as errors, it currently fails the build.

References

• Fix docutils errors from directives nested in myst-example blocks #1099

Expected Behavior

It works like before.

To Reproduce

:::{grid-item-card} Title

- Foo

---

- Bar

:::

[amotl]

We fixed our documentation build by downgrading to myst-parser v4 with 24a8429.