Typst与LaTeX编译器

技能简介

TypeTex 是一项通过 API 将 Typst 和 LaTeX 源文档编译为 PDF 的服务。用户发送源代码，服务端完成渲染后返回 base64 编码的 PDF 文件。

业务背景

技术团队无需在本地部署复杂的LaTeX或Typst环境，即可通过API快速将技术文档、学术论文、报告模板转换为PDF。特别适合需要批量生成标准化文档的SaaS产品，降低运维成本的同时提升交付效率。

落地案例：某在线教育平台需要为学生自动生成带个人信息的结业证书。平台将证书模板（LaTeX源文件）与学生姓名、课程信息作为变量传入API，服务端实时编译返回PDF，无需维护本地编译集群。多文件项目支持允许上传校徽图片等辅助资源，确保输出格式统一专业。

能做什么

• 将 Typst (.typ) 文档编译为 PDF
• 将 LaTeX (.tex) 文档编译为 PDF
• 支持多文件项目，可附带辅助文件（模板、章节、图片等）
• 二进制文件（如图片）通过 base64 编码传输

使用说明

安装要求：无需本地安装，直接调用远程 API。若使用 Python 示例，需安装 requests 库：pip install requests

基本调用流程：

1. 准备文档源代码字符串
2. 构造 JSON 请求体，包含 content（主文件内容）、main_filename（入口文件名）、auxiliary_files（可选辅助文件字典）
3. POST 到对应端点：https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst 或 /latex
4. 解析响应，成功时提取 pdf_base64 字段并解码保存

健康检查：GET /public/compile/health 验证服务状态

输入与输出

见下方输入与输出表格。

风险提示

• 依赖外部托管服务，网络中断或服务端下线将导致不可用
• 敏感文档内容通过第三方服务器处理，存在数据泄露风险
• 编译错误仅返回简要信息，复杂调试仍需本地环境
• 大文件或高频调用可能受速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gregm711/typetex/SKILL.md
来源类型：GitHub 仓库