Formulix 文档
安装 / Formulix 0.1.2

Tiptap 3

使用 ProseMirror 原子节点与原生历史记录的扩展。

安装

npm install formulix-tiptap

在创建编辑器前加载 formulix-tiptap/formulix-ui.min.js，以 ESM 导入 formulix-tiptap，加入现有 extensions。使用应用中的同一份 Tiptap。已运行版本为 3.32.0。

配置

import Formulix from 'formulix-tiptap';
Formulix.configure({
  servidor: 'https://api.formulix.com.br',
  chave: 'YOUR_PUBLIC_KEY',
  idioma: 'zh-Hans',
  upload: uploadPng
});
editor.commands.openFormulix('formula'); // conta, grafico, quimica

在应用中实现 uploadPng(blob)：上传 PNG，返回解析为 URL 的 Promise。图像和绘图必须提供 upload 回调；媒体服务器需验证用户、PNG、大小和权限。

API / 公开密钥

默认地址为官方服务 https://api.formulix.com.br。密钥为可选项：不设密钥时，编辑器域名使用免费套餐；额度用尽后，对话框会显示注册链接。在控制台登记域名并选择套餐；登记覆盖其子域名，网站不设密钥也能继续使用。

预览和插入的内容会发送至 API。浏览器中只使用绑定域名的公开密钥，切勿放入管理端、SMTP 或 Mercado Pago 凭据。

API · 隐私说明

保存与限制

openFormulix 支持 formula / conta / grafico / quimica；双击重新编辑。formulixInline 和 formulixBloco 是保存已清理 HTML 的原子节点。保存 editor.getJSON() 或 editor.getHTML()，服务端清理时保留 MathML、表格与 data-*。对话框打开期间选区随事务映射；若 API 响应前目标已删除，则拒绝更新；只读模式禁止修改。远程协作/Yjs 尚未验证。3.32.0 已验证四类内容、JSON/HTML、历史记录、选区映射、清理及只读。

Word 的 OMML/RTF 剪贴板处理仍为 TinyMCE 专有路径。其他平台的 Word 粘贴和同时使用多种语言暂不支持。