MyST 允许非连续 header 级别增加

Question

我想生成顶部带有大 header 但下面的标题要小得多的页面。 所以例如

<h1> Big heading </h1>
Test

<h4> Small heading </h4>
test

但是，如果我立即从 #Big # Big Heading到#### Small heading的 go 我收到此警告：

警告：非连续 header 级别增加； H1 到 H4 [myst.header]

它实际上使用 h1 和 h2。 如果我以###开头，然后使用####它以 h1 开头。

有什么办法可以避免副标题过大？

Answer 1

您可以将suppress_warnings = ["myst.header"]添加到您的conf.py以禁用此检查，但它会对整个文档产生影响。