LaTeX 公式

插件信息

LaTeX 公式功能會把可編輯的公式源碼保存到 Docs 模型中,並在瀏覽器編輯器中渲染出來。

外掛模式

安裝

Shell
pnpm add @univerjs-pro/docs-latex @univerjs-pro/docs-latex-ui

使用

TypeScript
import { UniverDocsLatexPlugin } from '@univerjs-pro/docs-latex'import { UniverDocsLatexUIPlugin } from '@univerjs-pro/docs-latex-ui'import DocsLatexUIZhTW from '@univerjs-pro/docs-latex-ui/locale/zh-TW'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-latex-ui/lib/index.css'import '@univerjs-pro/docs-latex/facade'const univer = new Univer({  locale: LocaleType.ZH_TW,  locales: {    [LocaleType.ZH_TW]: mergeLocales(      DocsLatexUIZhTW,     ),  },})univer.registerPlugin(UniverDocsLatexPlugin)univer.registerPlugin(UniverDocsLatexUIPlugin)

如果你擁有 Univer 商業授權,請參考 在客戶端使用 License。

行動裝置支援

先設定行動版編輯器。在本頁外掛模式的初始化程式碼中,將下列桌面版註冊替換為同一套件匯出的行動版外掛,並在開啟文件前完成。保留模型外掛、樣式、語言套件與 Facade 匯入,請勿同時註冊兩個版本。

套件桌面版註冊行動版註冊
@univerjs-pro/docs-latex-uiUniverDocsLatexUIPluginUniverDocsLatexMobileUIPlugin

Facade API

呼叫 LaTeX API 前先引入 facade 入口:

TypeScript
import '@univerjs-pro/docs-latex/facade'

向目前文件插入公式:

TypeScript
const doc = univerAPI.getActiveDocument()const formula = doc?.insertLatexFormula({  latex: 'E=mc^2',  index: 12,})

讀取並更新公式:

TypeScript
const formulas = doc?.getLatexFormulas() ?? []const firstFormula = doc?.findLatexFormulaByText('mc')firstFormula?.update({  latex: '\\frac{a}{b}',})

也可以按 range id 或文件 data-stream offset 查詢:

TypeScript
const byId = doc?.getLatexFormula('formula-range-id')const atOffset = doc?.getLatexFormulaAt(42)console.log(byId?.describe(), atOffset?.getLatex())

你覺得這篇文檔如何?

© 2026 DreamNum Co., Ltd.