texpile/texpile · 上手攻略

  • 仓库:texpile/texpile
  • 链接:https://github.com/texpile/texpile
  • 分类:学术工具 · 文档编辑
  • 作者:Tom
  • 更新:2026-09-04

是什么

Texpile 是一款现代化的桌面编辑器,同时支持 LaTeX、Typst 和 Markdown 三种文档格式。它最大的特点是同时提供可视化编辑(WYSIWYG-like)和源码编辑(带高级 IntelliSense 语法高亮和自动补全),并且100% 离线运行,无需注册账号

当前版本从 texpile.com/download 下载,支持 Windows、macOS、Linux 三大桌面平台。它存储为原生 .tex.typ.md 文件,不绑定任何专有格式,编辑结果可以无缝迁移到任何其他工具。

核心功能包括:可视化表格/方程/引用编辑、实时 PDF 预览(LaTeX)、实时协作(端对端加密共享会话)、评论功能,以及基于 LaTeX Workshop 的专业 LaTeX IntelliSense。

解决什么问题

LaTeX 学术写作有几个长期痛点: - 编辑器选择两难:Overleaf 在线的隐私风险和速度问题;本地 TexShop/Texworks 界面老旧,功能弱;VS Code + LaTeX Workshop 配置复杂。 - 实时预览体验差:大多数本地编辑器预览和源码分离,需要手动编译才能看到 PDF。 - 协作困难:Overleaf 的免费版协同时有文件数限制,且多人同时编辑同一文件时体验不佳。 - Typst 的 GUI 缺失:Typst 作为"LaTeX 替代者"速度快、语法简洁,但目前大多数编辑器对 Typst 的支持还很初级。

Texpile 的解法是:给 LaTeX/Typst/Markdown 各配一个现代化的图形前端,既保留源码的直接可控,又提供可视化编辑的直观体验,同时不把文档锁在任何云服务里。

快速安装

第一步:下载 Texpile

访问 texpile.com/download,选择你的操作系统(Windows / macOS / Linux)下载安装包,完成安装。

第二步:安装编译器(可选,仅生成 PDF 时需要)

LaTeX 编译器(三选一): - TeX Live(跨平台,推荐 Linux/Windows) - MacTeX(macOS 专用) - MiKTeX(Windows 专用,轻量些)

Typst 编译器(一个程序): - tinymist:Typst 的官方 LSP 服务器,Texpile 对 Typst 的支持依赖它

⚠️ 如果你只编辑 Markdown,不需要安装任何编译器。

安装完成后,在 Texpile 的 Preferences 或文档设置中指定编译器路径(如果 Texpile 没有自动检测到的话)。

第三步:开始编辑

打开 Texpile,直接新建或打开一个 .tex.typ.md 文件即可。LaTeX 文件在源码视图编辑时,PDF 会实时刷新重排(LuaLaTeX 编译器驱动)。

核心用法

可视化编辑

Texpile 的可视化编辑覆盖了 LaTeX 中最复杂的元素: - 表格:单元格合并、多行(multirow)、复杂边框 - 数学公式:多行公式、矩阵、对齐环境 - 引用:BibTeX 文献引用(可视化插入和编辑) - 图形:TikZ 图形可视化预览

操作方式:在源码中点击任意元素,可视化编辑器会高亮对应区域并允许直接编辑。

实时 PDF 预览(LaTeX)

在源码视图输入文字时,PDF 页面会即时重排。较大的结构性变更(新增章节、插入图表)可能需要短暂重新编译,但大多数文本修改是实时渲染的。

共享会话(实时协作)

无需注册账号即可协作:

  1. 在 Texpile 中打开要共享的文件夹
  2. FileShared Session,生成一个会话码
  3. 协作者在 Texpile 启动页输入会话码,即可加入实时编辑
  4. 所有流量端对端加密,中继服务器只能看到加密数据

评论功能

支持在文档任意位置添加评论,在可视化编辑器和源码编辑器中均可见,适合审稿和协作批注。

LaTeX IntelliSense

Texpile 的 LaTeX 语法补全、导航和错误提示大量继承自 LaTeX Workshop(VS Code 热门插件),包括: - 补全 LaTeX 命令、环境名称、包名 - 双向跳转(PDF ↔ 源码,光标位置同步) - 编译错误实时显示

典型适用场景

  • 学术论文写作:期刊/会议论文、硕博士论文,配合 TeX Live + 可视化表格/公式编辑,体验现代
  • Typst 尝鲜:如果你想从 LaTeX 迁移到 Typst,Texpile 提供了目前最好的 Typst 图形化编辑体验
  • 团队协作写书/文档:多人共享会话,无需 Overleaf 账号,数据完全本地
  • 技术文档(Markdown):Markdown 实时预览,支持编辑 .md 文件
  • 隐私敏感文档:完全离线,不经过任何服务器,文档只存在本地磁盘

坑与注意

  1. 编译器需要自行安装:Texpile 本身不包含 LaTeX/Typst 编译器,需要从零安装 TeX Live(Windows/Linux)或 MacTeX(macOS),tinymist 也需要单独装。
  2. macOS 安装 TeX 较大:TeX Live / MacTeX 完整安装包含数万种宏包,占用数 GB 磁盘空间,安装时间较长;建议用 MacTeX 的 minimal 版本或 MiKTeX(按需下载宏包)。
  3. 实时预览仅限 LaTeX:Typst 的预览速度应该也很快,但 README 没有明确提到 Typst 的实时预览能力;Markdown 本身所见即所得。
  4. 无内置 AI 功能:相比 Overleaf 内置的 AI 写作辅助,Texpile 完全依赖外部工具做 AI 辅助写作。
  5. 协作需要同时在线:共享会话是实时协作,不是异步的——协作者需要同时打开 Texpile 并连接会话码。
  6. 非真正所见即所得:可视化编辑器提供结构化元素的图形化操作,但最终 PDF 渲染效果仍以编译器输出为准,两者之间可能有细微差异。
  7. Stars 较低:项目 Stars 177,周增 +18,属于较小众但稳定维护的项目,评估长期维护风险时需注意。

与同类对比

工具 平台 LaTeX Typst Markdown 可视化编辑 协作 离线
Texpile Win/Mac/Linux ✅ 强 ✅ 强 ✅ E2E 加密
Overleaf 浏览器 ✅ 强 ⚠️ 有限 ✅ 免费版有限制
TeXShop macOS
VS Code + LaTeX Workshop 跨平台 ✅ 强 ⚠️ 基础 ⚠️ 基础
Typst App 浏览器/桌面 ✅ 官方 ⚠️ 基础 ⚠️ 基础 ⚠️ 需注册 ⚠️ 部分
Marktext Win/Mac/Linux ✅ 强

Texpile 的核心差异化是三格式通吃 + 可视化 + 本地协作:你不需要为 LaTeX 开一个工具、为 Typst 开另一个、为 Markdown 再开一个。同时 Overleaf 的隐私问题在 Texpile 里完全不存在。

一句话推荐结论

学术写作者如果想完全掌控自己的文档、不依赖 Overleaf 的在线服务,同时需要一个现代化、支持 Typst、还能实时协作的本地编辑器,Texpile 是目前最值得尝试的选择——尤其是同时写 LaTeX 和 Typst 的人,一款工具覆盖两种格式。