Typst 如何安装与配置5分钟编译出第一份 PDF【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst论文明早交稿LaTeX 改一行要重编十分钟。Typst 是一套基于标记语言的排版系统写下的标记直接变成 PDF编译通常在 1 秒内完成。本文带你装好编译器并验证、跑通第一份文档、接上编辑器自动预览、排掉字体与中文字段。从 LaTeX 换到 Typst 的理由这节回答「值不值得换」。编译是单遍的整份文档一次通过不存在多遍依赖收敛小型文档 1 秒内出结果。语法是纯文本标记标题就是一个没有\begin{...}\end{...}的环境嵌套。常用排版内置表格、编号、图表引用都是现成函数不用翻包名。报错直接给出行号和列位置定位错误不用猜。脚本即语言循环、条件、函数都是原生语法文档自动化不用宏包。装好之前先花 30 秒确认机器没问题。动手装之前的 30 秒自查对照这张表四项都满足就能直接开始项目最低要求系统Windows 10、macOS 10.15 或主流 Linux 发行版磁盘约 100 MB 可用空间网络能访问发行渠道即可仅升级、装包时需要前置依赖无仅源码编译需要 Rust 1.92门槛都满足的话下面按你的系统选一条路走。各系统最快安装路径这节只给一条首选命令和一条验证命令跟着敲就行。Windowswinget 一行装好winget install --id Typst.Typst新开终端验证typst --version预期输出形如typst 0.15.1 (提交号)能看到版本号即成功。也可以从 Typst 官网发布页手动下载 Windows 包解压后把目录加入 PATH。macOSbrew 三分钟搞定brew install typst typst --version预期输出typst 0.15.1 (提交号)。也可以从官网发布页下载 macOS 包解压到/usr/local/bin即可。Linux包管理器或源码二选一Debian/Ubuntu 系sudo apt install typst typst --version预期输出typst 0.15.1 (提交号)。发行版没有现成包时用 Rust 1.92 源码编译cargo install --locked typst-cli编译约 3~5 分钟。容器环境Docker 构建验证git clone https://gitcode.com/GitHub_Trending/ty/typst cd typst docker build -t typst . docker run --rm typst --version预期最后一条命令输出版本号。仓库根目录的 Dockerfile 基于 alpine 构建入口点直接就是 typst 可执行文件。想升级到最新版typst update升级出问题还可以typst update --revert回退到上一版本。装好只是开始下面让它真正干活。5分钟跑通第一个文档这节让你第一次亲手生成一份 PDF。新建hello.typ#set page(paper: a4) #set heading(numbering: 1.) 简介 Typst 是一套基于标记语言的排版系统。 $ E mc^2 $ - 第一个条目 - 第二个条目编译并观察两种模式typst compile hello.typ typst watch hello.typ第一条命令终端输出hello.pdf同目录下出现同名 PDF成功第二条先完成一次编译随后常驻监视保存文件即自动重编。链路是这样的编译能跑通后命令层面只需要记住一小撮。高频命令速查按场景分好组总共 7 条背下来够用场景命令作用什么时候用编译typst compile in.typ单次编译默认输出同名.pdf提交前、CI 中编译typst compile in.typ out.pdf指定输出路径需要自定义文件名时编译typst eval 2 3直接求值一段代码快速验证表达式监视typst watch in.typ文件变动自动重编本地写作期间常驻字体typst fonts列出所有已发现字体装完字体后确认排查typst info打印系统、字体路径等环境信息环境行为不符合预期时帮助typst help watch查看单条命令详细用法忘了参数时命令行只是底线编辑器里写文档才是日常。编辑器接自动编译VS Code 与 Neovim这节把「保存即预览」配上。VS Code装官方 Typst 扩展工作区settings.json加两行{ typst.compileOnSave: true }保存后侧栏自动刷新 PDF 预览即算配好。Neovim0.11装语言服务器 tinymist配置里启用vim.lsp.install(tinymist) vim.lsp.enable(tinymist)装好后打开.typ文件出现诊断、补全即成功。其他编辑器各有一个插件Emacs 用 typst-mode、Vim 用 vim-typst、Sublime Text 装 Typst 包。编辑器顺了接下来处理最容易翻车的字体。字体与中文排版配置只讲两类场景每类一条命令加一个声明。自定义字体路径字体放在项目外时临时传路径给编译命令typst compile --font-path ./fonts doc.typ想全局生效设环境变量TYPST_FONT_PATHS指向你的字体目录即可效果等同每次加--font-path。中文字体先装一套再在文档里声明sudo apt install fonts-noto-cjk文档开头加一行字体名以typst fonts输出为准#set text(font: 思源宋体 CN)中文段落不再出现方块字即配置成功。字体和路径问题占了报错的大半下面把高频故障一次排掉。六个常见报错的排查路径症状中文显示为方块豆腐字→ 系统没有中文字体 →sudo apt install fonts-noto-cjk再按上一节声明字体名。症状提示找不到某字体→ 自定义字体目录没传进去 →typst compile --font-path ./fonts doc.typ。症状command not found: typst→ 未安装或 PATH 未刷新 → 重跑对应系统的安装命令新开终端再typst --version验证。症状改了文档 PDF 却没变→ 用的是一次性compile它不会持续监听 → 改用typst watch doc.typ。症状图片显示不出来→ 路径是相对.typ文件解析的 → 确认相对路径拼写格式限 PNG、JPEG、WebP、SVG。症状同一文档不同机器结果不一致→ Typst 版本不同 → 两边都执行typst update统一到最新版。排障清单看完老 LaTeX 用户可以对着下表搬家了。LaTeX 转 Typst 对照表常用元素的新写法如下LaTeX 写法Typst 写法\section{标题} 标题\textbf{文本}**文本**\emph{文本}_文本_\begin{itemize}...\end{itemize}- 条目\begin{enumerate}...\end{enumerate} 条目$Emc^2$$ E mc^2 $\includegraphics{file}#image(file.png)\begin{tabular}...\end{tabular}#table(...)想让整体版式贴近 LaTeX 的观感在文档头部放这几行#set page(paper: a4, margin: 1.75in) #set par(leading: 0.55em, spacing: 0.55em, first-line-indent: 1.8em, justify: true) #show heading: set block(above: 1.4em, below: 1em)一句话建议声明标题、编号交给排版引擎的习惯可以直接保留而环境嵌套和自写宏包的习惯必须放下Typst 里一律换成函数调用和set/show规则。日常写熟了之后可以把重复的版式沉淀下来。进阶玩法模板函数与项目初始化模板函数解决「每份报告都要重复敲页眉页脚」的问题把版式写成一个函数// template.typ #let report(title, content) { #set page( margin: 1.5in, header: [#title], footer: [第 #counter(page).display() 页], ) #align(center)[#text(weight: bold, size: 24pt)[#title]] #content }文档里两行接入#import template.typ: report然后#show: report(我的报告)正文照常写。新项目则用typst init从模板起步它会在当前目录生成一份带完整结构的.typ入口文件预期输出是新建的文件名。到这里编译、监视、字体、排障、模板都通了剩下的路自己选方向。下一步Typst 的安装只花了几分钟真正的价值在于把排版交给标记本身你写内容它管版面编译以秒计。接下来建议按顺序走三步先读教程章节补语法体系再通读官方示例集当语法手册最后去社区模板市场挑一个起步模板。docs/content/官方文档源含教程、语言参考与迁移指南tests/suite/按主题分目录的官方示例集可直接编译对照效果Typst 官方论坛提问与讨论的主阵地Universe 模板社区按场景挑现成模板【免费下载链接】typstA markup-based typesetting system that is powerful and easy to learn.项目地址: https://gitcode.com/GitHub_Trending/ty/typst创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考