gbt9704-gongwen – Typst Universe

GB/T 9704-2012 Official Document Format — Typst Template

Version: 0.2.0

A Typst template implementing GB/T 9704-2012, the Chinese national standard for official government document layout.

Features

Strict GB compliance: page margins, font sizes, line spacing, heading fonts, indentation, justified alignment.
Document element functions: red-header, main receiver, attachments, signatures, dates, end-matter (版记).
Red and black separator lines for red-header and end-matter respectively.
Configurable spacing themes: compact | normal | relaxed — three line-spacing presets.
Configurable table themes: full-grid (default) | three-line | plain — three table border styles.
Faux bold table headers: CJK-friendly text-stroke technique for fonts without native bold variants.
CJK font fallback chain with open-source alternatives (FZDaBiaoSong → SimHei, FangSong → SimSun, etc.).

Quick Start

typst init

typst init @preview/gbt9704-gongwen

Manual import

#import "@preview/gbt9704-gongwen:0.2.0": *
#show: gbt9704.with(redline: true, title-indent: true)

// Your document content here ...

Options

Parameter	Type	Default	Description
`redline`	bool	`false`	Red separator line below red-header
`title-indent`	bool	`true`	Indent section headings 2 characters
`spacing-theme`	str	`"normal"`	Line spacing preset: `"compact"` / `"normal"` / `"relaxed"`
`table-theme`	str	`"full-grid"`	Table border style: `"full-grid"` / `"three-line"` / `"single-line"` / `"plain"`
`table-align`	str	`"center"`	Table horizontal alignment: `"center"` / `"left"` / `"right"`
`show-red-header`	bool	`true`	Show the red-header block / 红头显隐
`first-page-number`	bool	`true`	Show page number on the first page / 首页是否显示页码
`page-number-pos`	str	`"both"`	Page number position: `"both"` / `"center"` / `"left"` / `"right"` / 页码位置

Spacing Themes

Theme	`leading`	`spacing`	`heading-v`	Feel
`compact`	0.75em	0.5em	0.5em	Tight GB/T grid
`normal`	0.75em	0.5em	1em	Balanced (default)
`relaxed`	0.7em	0.5em	2%	Airy, relaxed

All three themes share the same paragraph spacing (0.5em), so “paragraph gap = line gap + 8pt” holds consistently.

Table Themes

Theme	Effect
`full-grid`	All cell borders (default)
`three-line`	Top thick + header-bottom thin + bottom thick, no verticals
`single-line`	Header-bottom 1pt line only, zebra stripes
`plain`	No borders, centered only

Changelog

v0.2.0

Add show-red-header parameter — toggle entire red-header block
Add first-page-number parameter — suppress page number on first page
Add page-number-pos parameter — "both" / "center" / "left" / "right"
Add endmatter() function — bottom-aligned CC + issuing info block with separator lines
Page number format: - 1 - style
Red line at bottom of first page (when redline: true)
Signature: 3 blank lines before signature block, signatory right-aligned
Bilingual README (EN + ZH)

v0.1.1

Add spacing-theme parameter: "compact" / "normal" / "relaxed"
Add table-theme parameter: "full-grid" / "three-line" / "single-line" / "plain"
Add table-align parameter: "center" / "left" / "right"
Faux bold table headers via text stroke (CJK-friendly)
Table centering with paragraph indent neutralization
All spacing values use em units (font-size-relative)
Refactored src/ layout: spacing.typ + table.typ + lib.typ

v0.1.0

Core Functions

Function	Description
`gongwentitle(title)`	Document title — 22pt red title font, centered
`gongwensubtitle(subtitle)`	Subtitle — 16pt FangSong, centered
`make-header(organ, number, signatory, redline)`	Red-header: organ name, document number, signatory
`main-receiver(receiver)`	Main receiver — flush left, no indent
`attachment(title)`	Single attachment with “附件：” prefix, 2-char indent
`attachment-no-hz(title)`	Attachment without prefix, 5-char block indent
`attachment-item(title, indent)`	Attachment item with custom indent
`signature(name)`	Signature — right-aligned, 2-char right margin
`signdate(date)`	Date — same format as signature
`notes(text)`	Notes in parentheses, no indent
`copyto(text)`	CC field with “抄送：” prefix
`issueinfo(organ, date)`	Issuing organ and date, left-right aligned
`seprule`	Black separator line for end-matter (版记)
`redrule`	Red separator line for red-header

Heading Levels

Level	Syntax	Font	Size
1	`=`	SimHei (黑体)	16pt
2	`==`	KaiTi bold (楷体加粗)	16pt
3	`===`	FangSong bold (仿宋加粗)	16pt

Font Dependencies

Fonts are listed in priority order; fallbacks are used automatically.

Font	Purpose	Fallback
FZDaBiaoSong-B06 (方正大标宋)	Red-header, document title	SimHei (黑体)
FangSong (仿宋)	Body text	SimSun (宋体)
SimHei (黑体)	Level-1 headings, table headers	Noto Sans CJK SC
KaiTi (楷体)	Level-2 headings	STKaiti, Noto Serif CJK SC
SimSun (宋体)	Auxiliary	Noto Serif CJK SC

Project Structure

gbt9704-gongwen/
├── src/
│   └── lib.typ               # Template source
├── template/
│   └── main.typ              # typst init template
├── examples/
│   ├── example.typ           # Full document example (zh)
│   ├── example-en.typ        # Full document example (en)
│   ├── manual.typ            # Usage manual (zh)
│   └── manual-en.typ         # Usage manual (en)
├── typst.toml
├── LICENSE
└── README.md

Examples

Compile the examples:

# Chinese — red-header, tables, attachments, end-matter
typst compile --root . examples/example.typ

# English
typst compile --root . examples/example-en.typ

# Chinese usage manual (API reference)
typst compile --root . examples/manual.typ

# English usage manual
typst compile --root . examples/manual-en.typ

Pre-compiled PDFs:

Changelog

v0.1.0 (2026-07-09)

First Typst release: Full GB/T 9704-2012 official document format support.
A4 page, GB-standard margins (L 28mm, R 26mm, T 37mm, B 35mm), 28pt line spacing.
Document element functions: red-header, title, main receiver, attachment, signature, date, end-matter, notes, CC.
Chinese heading numbering (一、（一）、1.), first-line indent, centered tables.
Font sizes: title 22pt, body 16pt, document number 12pt.
Font fallback: FZDaBiaoSong, FangSong, SimHei, KaiTi, SimSun + open-source alternatives.
typst init @preview/gbt9704-gongwen quick-start template.

中文简述

GB/T 9704-2012《党政机关公文格式》Typst 模板。严格遵循国标：A4 页面、国标边距、28 磅行距、三号仿宋正文、首行缩进 2 字符。提供红头、主送、附件、署名、日期、版记等公文要素函数。支持三档行间距主题（紧凑/正常/宽松）和三档表格样式（全线表/三线表/无线表）。字体回退链覆盖方正大标宋、仿宋、黑体、楷体、宋体及开源替代。

详细中文手册见 manual.pdf。

Feedback & Contributing

Issues: https://codeberg.org/songwupei/typst-gbt9704/issues
Repository: https://codeberg.org/songwupei/typst-gbt9704

Create project in app

How to use

Click the button above to create a new project using this template in the Typst app.

You can also use the Typst CLI to start a new project on your computer using this command:

              typst init @preview/gbt9704-gongwen:0.2.0

About

Author:

songwupei

License:

MIT

Current version:

0.2.0

Last updated:

July 27, 2026

First released:

July 15, 2026

Minimum Typst version:

0.13.1

Archive size:

8.94 kB

Repository:

Codeberg

Category:

Report

Explore more packages by songwupei

Where to report issues?

This template is a project of songwupei. Report issues on their repository. You can also try to ask for help with this template on the Forum.

Please report this template to the Typst team using the contact form if you believe it is a safety hazard or infringes upon your rights.

Version history

Version	Release Date
0.2.0	July 27, 2026
0.1.0	July 15, 2026

Typst GmbH did not create this template and cannot guarantee correct functionality of this template or compatibility with any version of the Typst compiler or app.