- 开箱即用的封面：课程、学院、班级、姓名、学号等信息一处填写
- 统一的报告版式：自动处理页眉、页脚、页码、标题编号与正文间距
- 丰富的内容组件：支持图片、表格、数学公式、代码高亮、提示框与重点标注
- 规范的文献引用：内置 BibTeX 工作流和 GB/T 7714 数字引用样式
- Typst 极速编译：语法清晰，实时预览，适合课程作业与实验报告的快速迭代
确保已经安装 Typst；如果使用 VS Code，推荐安装 Tinymist Typst 扩展，以获得语法高亮、自动补全和实时 PDF 预览。
git clone https://github.com/xmdjy/sdu-report-template.git
cd sdu-report-template
typst compile --root . examples/demo.typexamples/demo.typ 是完整的功能演示，编译它可以先看看模板长什么样。写自己的报告时，在仓库里新建一个文件（例如 report.typ），引用 lib.typ 即可：
#import "./lib.typ": *
#showpage(
course: "课程名称",
college: "学院名称",
class: "班级",
author: "姓名",
stdid: "学号",
title: "实验名称",
)
#reportpage[
= 实验目的
在这里开始撰写你的实验报告。
]如果该版本已发布至 Typst Universe，可以直接创建一个新项目：
typst init @preview/xmdjy-sdu-report-template生成的目录里 main.typ 已经写好骨架，ref.bib 用于参考文献。也可以在已有项目中直接导入：
#import "@preview/xmdjy-sdu-report-template:0.1.1": *随后使用与上方相同的 #showpage(...) 和 #reportpage[...] 即可。
模板已经配置好常见实验报告元素：
// 图片
#figure(
image("../images/example.png", width: 75%),
caption: [实验流程图],
)
// 三线表
#table(
columns: (1fr, 2fr, 1fr),
stroke: none,
table.hline(stroke: 1.2pt),
table.header([*阶段*], [*研究内容*], [*应用*]),
table.hline(stroke: 0.6pt),
[需求分析], [明确实验目标与约束], [方案设计],
[实验验证], [记录并分析实验数据], [结果评估],
table.hline(stroke: 1.2pt),
)
// 数学公式
$ E = m c^2 $
// 提示框
#idea[记录一个关键思路。]
#warning[标注实验中的注意事项。]
// 文献引用
相关工作可参考 @rawles2024androidworlddynamicbenchmarkingenvironment。
#bibliography("ref.bib", style: "gb-7714-2015-numeric", title: "参考文献")代码块会自动启用语法高亮：
#codly(languages: codly-languages)
```python
def hello_typst():
print("Hello, Typst!")
```sdu-report-template/
├── assets/ # 学校标识与模板内置图片素材
├── images/ # 用户报告中使用的图片资源
├── lib.typ # 模板核心样式与排版配置
├── thumbnail.png # 模板预览图
├── typst.toml # Typst 包信息
├── examples/
│ ├── demo.typ # 完整功能演示（引用 ../lib.typ）
│ └── demo.pdf # 演示的编译结果
└── template/ # typst init 生成的起始文件
├── main.typ # 报告骨架（引用已发布的包）
└── ref.bib # BibTeX 参考文献
为获得与预览图一致的效果，建议安装：
- Songti SC（中文正文）
- Heiti SC（中文标题）
- Kaiti SC（封面信息）
- Times New Roman（英文正文）
- JetBrains Mono（可选，用于代码块）
0.1.1— 优化模板细节与依赖包（2026-03-13）0.1.0— 首个公开版本（2026-02-16）
如果模板对你有帮助，欢迎点一个 ⭐ Star。遇到排版问题、希望支持新的报告样式，也欢迎提交 Issue 或 Pull Request。
写得更快，排得更好。
Made with Typst · Released under the MIT License