Typst 写作

复用 Glyphweave 的 HTML 编译与可选 PDF 输出。

文章目录

inkstack new --format typst --slug typeset-note --title "排版笔记" --pdf

content/typst-posts/typeset-note/
  post.yaml
  index.typ
  assets/

post.yaml 为唯一元数据来源，index.typ 为正文；PDF 必须显式开启。

title: 排版笔记
slug: typeset-note
description: 公式与排版的记录。
date: '2026-10-07'
tags: [Typst]
status: draft
visibility: public
language: zh-CN
source: index.typ
pdf: true

标题与公式

= 排版笔记

== 一个章节

行内公式 $E = m c^2$。

$ sum_(i=1)^n i = (n(n+1))/2 $

=== 章节内的小节

#image("assets/diagram.svg", width: 70%)

顶层标题与元数据标题保持一致。加载边界移除文档标题，将剩余标题映射到站点 h2–h4，并交给同一个文章布局与 TOC 组件。

Typst 数学输出可能是 MathML 或 SVG，不能用替换所有 SVG 的方式保证与 KaTeX 一致。主题提供统一数学容器、字体和溢出策略；编译表示仍由 Typst 决定。

图片与依赖

文章资源只使用文章内的相对路径。现有 .typ 文件可使用导入向导，迁移静态 image()、read()、bibliography() 和本地 import/include 依赖。

动态拼接路径、自定义函数或别名、复杂运行时资源需要人工迁移并真实编译。@preview 包引用保留，预检会提醒；包是否能获取以构建结果为准。Typst 文件路径不接受 HTTP/HTTPS URL，先将文件保存到允许资源根。

草稿与 PDF

inkstack dev 编译隔离源副本，草稿正文带预览标记并 noindex。它不会把作者元数据改成已发布，也不会修改生产索引。正式构建排除草稿、private 和 archived 的正文、资源及 PDF。

inkstack check --content-only
inkstack build
inkstack preview --no-build

PDF 验收检查字体是否嵌入。Typst HTML 是实验接口，编译器固定 0.15.0；升级时必须重新跑单元、真实集成和三浏览器验收。官方语法参考：Typst 文档。