1
#let theme = (
2
  text-font: "Noto Sans SC",
3
  heading-font: "Noto Sans SC",
4
  text-size: 20pt,
5
  category-size: 50pt,
6
  title-size: 30pt,
7
  separator-size: 50pt,
8
  sub-size: 12pt,
9
  color: rgb("#111"),
10
  gray: rgb("#6b7280"),
11
  line-height: 1,
12
  indent: 2em,
13
  para-spacing: 2em,
14
)
15

16
#let zh-paragraph() = {
17
  set par(justify: true, first-line-indent: theme.indent,
18
          leading: theme.line-height * 1em, spacing: theme.para-spacing)
19
  set text(lang: "zh", font: theme.text-font, size: theme.text-size, fill: theme.color)
20
}
21

22
#let article-card(
23
  title, body,
24
  category: none, subtitle: none,
25
  category-size: none, title-size: none, separator-size: none, body-size: none
26
) = block(
27
  // 用 block 而不是 box：block 是可分页的
28
  fill: white,
29
  inset: 22pt,      // 内边距
30
  radius: 8pt,      // 圆角
31
  stroke: none,
32
  width: 440pt,     // 版心宽度（可调）
33
  breakable: true,  // 显式允许跨页（缺省也是可分页）
34
)[
35
  // 标题
36
  #set text(font: theme.heading-font, weight: "bold")
37
  #if (category != none) [
38
    #text(size: if category-size != none { category-size } else { theme.category-size })[#category]
39
    #text(size: if separator-size != none { separator-size } else { theme.separator-size })[ ｜]
40
  ]
41
  #text(size: if title-size != none { title-size } else { theme.title-size })[#title]
42

43
  // 副标题（可选）
44
  #if (subtitle != none) [
45
    #v(6pt)
46
    #set text(font: theme.heading-font, size: theme.sub-size, fill: theme.gray)
47
    #subtitle
48
  ]
49

50
  #v(10pt)
51

52
  // 正文
53
  #set par(justify: true, first-line-indent: theme.indent,
54
           leading: theme.line-height * 1em, spacing: theme.para-spacing)
55
  #set text(lang: "zh", font: theme.text-font,
56
            size: if body-size != none { body-size } else { theme.text-size },
57
            fill: theme.color)
58
  #body
59
]
60

61

62
// 使用示例
63
#article-card(
64
  category: "模板",
65
  // subtitle: [可选的副标题写这里，注释去掉即可。],
66
  "这份 Typst 文章模板怎么用（小白向）",
67
  [
68
本模板用于排一个白底内容卡片：上方是“分类｜标题”，下面是正文。容器可自动分页，所以写长文也不用担心被截断。
69

70
一、写正文
71
把每个自然段直接放在这里，每两个段落之间留一个真正的空行即可。若从网页粘贴导致空行里混入全角空格，看起来空但其实不空，段落就不会分开；遇到这种情况，手动敲一个空行，或把光标放在空行里按删除直到行首没有任何字符。
72

73
二、改样式
74
想要无衬线风格（黑体），已默认使用 Noto Sans SC；若你电脑没有该字体，可以在上面的 theme 里把 text-font / heading-font 改成系统里存在的字体，例如 Source Han Sans SC 或 Microsoft YaHei。
75

76
三、改字号与间距
77
段内行距由 line-height 控制（数值越大越疏），段间距由 para-spacing 控制（例如 2em）。你也可以在调用 article-card 时单独覆盖 body-size（正文字号）。
78

79
四、改标题行
80
分类、标题和分隔竖线的字号分别受 category-size、title-size、separator-size 控制；留空就用 theme 里的默认值。不要分类时，把 category 参数去掉即可。
81

82
五、版心宽度
83
内容卡片的宽度是 440pt，可在 article-card 的 width 参数上调整；页面边距想更大，可在外部用 set page(margin: ...) 调整。
84

85
开始写作吧：把这段说明删掉，换成你的正文即可。
86
  ],
87

88
)