LaTeX Visualizer

一个完全本地运行的 LaTeX 阅读工具，仓库包含互不依赖运行环境的两个版本：

目录	用途	运行要求
web/	浏览器中的双栏编辑与阅读页面	Node.js 18+；构建后是纯静态网页
sublime-text/	Sublime Text 4 原生公式预览插件	Sublime Text 4、Node.js 18+

两部分都只在本地处理文本，不调用 AI，也不会上传文档。它们可以分别安装、测试和部署；无需同时运行。

快速开始

网页版

cd web
npm ci
npm run dev

浏览器打开终端显示的地址。生产构建输出到 web/dist/：

npm test
npm run build
npm run preview

完整功能与静态部署方式见 web/README.md。

Sublime Text 插件

插件包含平台相关的本地渲染组件，请在准备安装插件的电脑上构建：

cd sublime-text
npm ci
npm test

然后在 Sublime Text 中选择 Preferences → Browse Packages…，把生成完整的 sublime-text/LaTeXVisualizer 文件夹复制到该目录。插件会自动加载，不需要启动网页版。

完整安装、设置和使用说明见 sublime-text/README.md。

功能

• 识别 $...$、$$...$$、\(...\)、\[...\] 和常见 equation / align / gather 环境。
• 支持常用数学、物理、矩阵和 mhchem 化学公式。
• 保留普通文字、换行、代码片段和原始 LaTeX；无效公式不会改写原文。
• 网页版支持本地草稿、主题、文本导入、HTML 导出和富文本复制。
• Sublime Text 版支持粘贴预览、悬停预览、选区预览及公式折叠。

仓库结构

latex-visualizer/
├── web/                    # 独立网页应用、测试和 npm 配置
│   ├── src/
│   └── test/
└── sublime-text/           # 独立 Sublime Text 插件工程
    ├── LaTeXVisualizer/    # 复制到 Sublime Packages 的插件目录
    ├── scripts/            # 本地构建脚本
    ├── src/                # Node 公式渲染器源码
    └── test/

隐私与限制

所有解析与渲染均在本机完成。该项目不是完整 TeX 编译器，不处理整篇 \documentclass 文档、TikZ 或任意宏包，也不会猜测没有明确标记的行内公式。