見出ししたい（#heading）

 1// 見出しレベルの表示設定
 2#set heading(
 3  numbering: "1.1.",
 4)
 5
 6// 見出しに背景色を設定
 7#show heading: it => {
 8  block(
 9    fill: luma(90%),
10    width: 100%,
11    spacing: 1em,
12  )[
13    #it
14  ]
15}
16
17// #heading(level, numbering, outlined)[content]
18#heading[見出し1]  // デフォルトは(level: 1)
19#heading(level: 2)[見出し2]
20#heading(level: 3)[見出し3]
21#heading(level: 4)[見出し4]  // 見出し4以降は見た目が同じ

heading要素 で「見出し」をマークアップできます。

numberingオプションで見出し番号の表示設定、 depthオプションで、目次に含める見出しレベルを設定できます。 これらはsetルールで全体設定するとよいです。 また、表示方法はshowルールで変更できます。

#headingのオプションを使うと、 個別の見出しをより細かく設定できます。

参考

マークアップしたい（=）

1= 見出し1
2== 見出し2
3=== 見出し3
4==== 見出し4

見出しは=でマークアップできます。 =の数が見出しレベルに相当します。

参考

Markdown記法では#に相当します。

レベルを変更したい（level）

1#heading(level: 2)[見出し2]

levelオプションで、見出しレベルを変更できます。

見出しを非表示にしたい（outlined）

#heading(outlined: false)[隠したい見出し]

outlinedオプションで、見出しを目次に追加するかどうかを変更できます。 outlined: falseで非表示にできます。

参考

outlined: falseは LaTeXの\section*に相当します。

背景色したい

 1// 基本設定
 2#set heading(numbering: "1.")
 3
 4// 全体設定
 5#show heading: set block(spacing: 1em)
 6
 7// 個別設定
 8#show heading.where(level: 1): block.with(fill: luma(150), inset: 12pt)
 9#show heading.where(level: 2): block.with(fill: luma(100), inset: 12pt)
10#show heading.where(level: 3): block.with(fill: luma(50), inset: 12pt)

#headingには背景色を設定するオプションがありません。 そのため、#showルールで変更します。

まず、#show heading: set block(spacing: 1em)で、すべての見出し要素をブロック要素に変換して、上下に1emのパディングを追加しています。

その後、#show heading.where(level: ...)で見出しレベルごとに個別設定しています。

参考