DOC2X格式转换

PDF 转 Typst 排版源码

把 PDF 解析内容导出为 Typst 项目,完整保留 .typ 与图片目录后编译。提供两页原稿、真实 ZIP、Typst 本地成品和公式表格核对,说明分页变化、图表文字缺失与缺图、字体警告的排查。

你的文件
PDF 解析结果;已有任务可直接导出
得到什么
含 .typ 与所需图片的完整项目
同一已有PDF任务的真实导出配置,选中Typst,图片高清化关闭,文件名为pdf-typst-output.zip
真实 Typst 导出配置 · 一份原生 ZIP,后续在本地编译;截图在下载后重新打开配置时取得。 点击查看完整大图
本页内容

核对解析内容,完整导出后再编译

  1. 上传 PDF 并完成解析,或打开已有结果;对照原页检查正文、公式、表格和图片。
  2. 打开导出,选择 Typst。本例保留公式、表格按原页保留,并关闭导出前图片高清化。
  3. 下载并完整解压 ZIP,保留 .typ 与 images 目录的相对位置,再用 Typst 编译。
  4. 打开编译后的 PDF,逐页核对公式、数据、图注和分页;需要模板或版式调整时再修改自己的副本。
上传 PDF,准备 Typst 导出

本例原生 ZIP 未改源码即可本地编译;字体、分页与图表说明仍需对照原稿。

一份真实 Typst 项目:原稿与本地编译成品

2026年10月12日,复用此前已完成解析的两页自编英文 PDF,实际导出一次 Typst ZIP。完整解压后用官方 Typst 0.15.1 编译,未改源码,得到两页 A4 PDF。本例保留原稿、原生文件包和本地成品,可逐项检查公式、表格与分页。

原稿第 1 页:公式、单位与三行数据
自编英文PDF原稿第一页,有速度分式、四列表格及定积分,正文使用原来的字体和分页查看原图 ↗
Typst 本地成品第 1 页:内容重新排版
未经修改的Typst源码编译成的第一页,速度公式、表格和积分可见,第四节标题已从原稿第二页移到本页查看原图 ↗

原生导出中的两条公式语句

$ v = s / t $
$ integral_0^1 x^2 upright(#h(0em) d) x = 1 / 3 $
  1. 原生 ZIP 恰含一个 2,460 字节的 .typ 文件与一张 JPEG;图片路径是 images/1_279_471_1061_604_0.jpg。源码没有 import 或 include,本例不需要额外下载 Typst 包。
  2. 本机能找到源码指定的 Noto Serif CJK SC、STIX Two Text 字体。完整项目在 Typst 0.15.1 下退出码为 0,没有警告;表格 A/B/C 三行的小数与原稿一致,两条展示公式已逐项对照。
  3. 原稿与成品都是两页 A4,但字体、段落和分页发生变化。第 4 节标题移到成品第 1 页,图仍在第 2 页;六个导出标题统一使用 level: 1,不能当成恢复了原作者的标题层级和模板。
  4. 图表以 JPEG 保存,编译后内嵌图像的字节与 ZIP 中图片相同。原图顶部“Distance s (m) | Constant-speed model: s = 3t”一行仍然缺失;这是此前解析图片已有的差异,编译成功没有补回它。

这是一份清晰英文原生文字 PDF,原稿标题和文中的 TeX 字样来自此前的转换实验,按原文保留。本轮没有新增上传、OCR、翻译或内容修订。PDF 成品由本地编译器生成,未测试 Typst 云端项目;扫描件、中文缺字、复杂模板和其他版本需另行核对。核对包另含明确标注的本地缺图与字体对照,它们不是更多产品导出。

先了解这几件事

PDF 转 Typst 先提取并核对文档内容,再选择 Typst 导出。解压后将 .typ 与它引用的图片放在对应目录,用 Typst 编译器生成 PDF。本页真实项目未改源码即可编译,但字体、标题层级和分页与原稿不同,图表仍是图片;导出后要继续检查内容和排版。

本例输入
两页自编英文 PDF,含公式、表格和图表。
原生下载
一个 .typ 文件与一张 JPEG,组成完整 ZIP。
实际编译
Typst 0.15.1,本地生成两页 A4 PDF。
核对边界
编译成功、原文完整和恢复原版面分别检查。

导出项目中的不同内容,分别如何验收

导出项目中的不同内容,分别如何验收
内容本例导出方式需要核对什么
公式Typst 数学语句,分式与定积分可继续编辑分子分母、积分上下限、指数和单位
表格四列表格源码,三行数据保留小数表头、行列与 A/B/C 对应关系
图表images 目录中的 JPEG图片完整性、图注和缺失标签;不能直接改曲线数据
标题与版面六个 level: 1 标题,重新分页按目标模板调整层级、字体与页边距

PDF 转 Typst 得到的是内容项目

这里的流程从 PDF 识别结果生成新的 Typst 源码。它不会找回原作者的宏、模板或可编辑图表。本例仍保留原稿里关于 TeX 的文字说明;文件内容使用 Typst 语法,后缀为 .typ。

公式语句可以编译,也要核对数学含义

本例导出的 v = s / t 呈现为分式,定积分的 0、1 上下限、平方与三分之一也已对照原稿。这样的核对只覆盖这几条简单表达式,复杂矩阵、多行推导和特殊符号仍要抽样验证。

表格是源码,图表仍是一张图片

四列表格以 Typst table 组织,A/B/C 的三行数值保持一致。折线图则是 JPEG,编译器保留了它的像素内容。需要改图中数据时,应回到原始数据或重新绘图,不能把图片引用当作可编辑图表模型。

页数相同,版面也可能不同

原稿和成品都为两页 A4,但第 4 节标题已经移到成品第 1 页,图表留在第 2 页。检查图与说明是否分开,按自己的文档模板调整;仅数页数不能验收排版。

先保留完整文件包,再处理本地编译问题

本例 .typ 在第 54 行引用 images 里的 JPEG。只拿走源码会丢失这条依赖;恢复同一目录后无需修改公式或表格,就能再次编译。字体警告和资源缺失的影响不同,可按下方指南逐步定位。

源码移入子目录后,重新核对图片引用

2026-10-13 用同一份既有下载补做六组本地路径对照。完整项目从其他工作目录调用仍能编译;只把源码移入 src 后,原 images 引用会查找 src/images,即使设置 --root 也不会自动改写它。调整副本引用并指定包含源码与图片的工程目录后,三组成功输出与原有 PDF 字节一致。完整命令与对照包见下方详细教程。

相关官方说明

详细操作教程

遇到这些情况

编译提示 file not found
按报错行核对图片引用,确认完整解压了 ZIP,而不是只复制 .typ 文件。
出现 unknown font family
先看是否仍生成了 PDF,再检查字体与字形。使用 typst fonts 查看可用字体,必要时配置适合文档语言的字体。
编译成功,图中说明仍少了一行
回到原 PDF、解析结果和 ZIP 图片逐项对照。本例缺失标签在解析图片中已经存在,编译器不会恢复图片之外的文字。

常见问题

PDF 转 Typst 后需要手工修源码才能编译吗?

本页这一份原生 ZIP 在指定本地环境下未改源码即可编译。其他文档的数学语法、字体、图片和模板需要各自验证。

只下载或复制 .typ 文件就够了吗?

看源码是否引用图片等资源。本例需要 images 目录中的一张 JPEG;只带源码会在图片引用处失败。

Typst 导出能保留原 PDF 排版吗?

本例是内容重新排版。虽然仍为两页 A4,字体、标题层级和分页已有变化;需要保留固定外观时,应先明确自己的输出用途。

图表也能像表格一样改数值吗?

本例表格是 Typst table,图表是 JPEG。前者可以修改源码中的单元格,后者不包含可直接编辑的图表数据对象。

网页版支持 Typst,API 也支持同样的格式吗?

本页验证的是网页版导出,没有调用 API。接口格式和条件请查看开放平台当前文档,不能从网页选项推定接口能力。

内容核对:2026-10-13 · 功能条件与配额以当前产品界面为准