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以禁用此檢查，但它會對整個文檔產生影響。