文档结构与行内标记

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

块级结构

空行分段；= 到 ====== 是一至六级标题，行尾可挂 <标签> 供引用；--- 是分隔线：

= 一级标题 <intro>
== 二级标题

第一段。段与段之间用空行分隔；
段内换行在两个汉字之间无缝相接，
在西文单词之间折为一个空格。

---

行末的 \ 是硬换行：该行到此为止，不参与两端对齐。

列表以 - （无序）或 + /1. （有序）开头，引用块以 > 开头，二者都可嵌套；/ 术语: 描述 逐行写出是描述列表，术语加粗，描述的续行悬挂缩进：

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

/ 断行: Knuth–Plass 全段最优
/ 挤压: 标点按出版规范压缩

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

行内标记

• *粗体* → 粗体；_强调_ → 强调（中文强调渲染为着重号）
• 反引号包裹行内代码：`code`
• [链接文字](https://example.com) → 链接文字
• 行内公式用美元号包裹：$a^2 + b^2 = c^2$ → a2+b2=c2
• 正文里的 https://… 网址自动成为链接，如 https://zball.io
• 词内的 * 与 _ 是普通字符：snake_case、2*3*4 原样排出，不构成强调（汉字之间的 *强调* 不受影响）
• 反斜杠只转义 ASCII 标点（\* 得到 *）；后面是字母、数字或汉字时原样保留，如 C:\temp

标签与引用

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

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