MyST allowing non-consecutive header level increase

Question

I want to generate pages with a large header at the top but much smaller headers below. So for example

<h1> Big heading </h1>
Test

<h4> Small heading </h4>
test

But if I go immediately from # Big Heading to #### Small heading I get this warning:

WARNING: Non-consecutive header level increase; H1 to H4 [myst.header]

and it actually uses h1 and h2. If I start with say ### and then use #### it starts with h1.

Is there any way to avoid having the subheadings being so large?

Answer 1

You can add suppress_warnings = ["myst.header"] to your conf.py to disable this check but it will have an effect on entire docs.