zball

Typesetter 文档

文档结构与行内标记

Typesetter 的源格式是 .tsm——一种 Markdown 风格、Typst 式可编程的标记语言。本页覆盖块级结构与行内标记;数学、代码与图表见后续各篇。

块级结构

空行分段;======= 是一至六级标题,行尾可挂 <标签> 供引用;--- 是分隔线:

=  <intro>
== 

第一段。段与段之间用空行分隔,
段内换行会被折叠为空格。

---

列表以 - (无序)或 + /1. (有序)开头,引用块以 > 开头,二者都可嵌套:

- 无序项
- 另一项
  > 嵌套的引用
+ 有序项一
+ 有序项二

%----% 之间是块注释,不参与排版输出。

行内标记

  • *粗体*粗体_强调_强调(中文强调渲染为着重号)
  • 反引号包裹行内代码: code
  • [链接文字](https://example.com)链接文字
  • 行内公式用美元号包裹:$a^2 + b^2 = c^2$$a^2 + b^2 = c^2$

标签与引用

标题、显示公式、图、表都可以携带 <标签>;正文用 @标签 引用,解析后自动变成带编号的链接(如§1指向本页标题)。中文标签用 @[中文标签] 的形式。引用的编号由 resolver 统一分配——章节 §n、图 图 n、表 表 n、公式 式 (n) 同源同序。

#toc 展开为目录,#term 定义术语并进入 #glossary 词汇表;这一族以 # 开头的可编程能力(splice)还包括 #let 变量与自定义 region/fence 处理器,属于进阶用法。