企业官网建设流程全解析

Tolaria数学公式支持：用KaTeX在笔记中渲染LaTeX完整指南

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria

Tolaria 是一款以 Markdown 文件为唯一数据源的桌面知识管理应用，从 v2026-05-12 版本起原生支持数学公式：用$...$写行内公式、用$$...$$写独立公式块，编辑器内置 KaTeX 引擎实时渲染，而保存下来的笔记依然是纯文本 Markdown，可在任何支持 LaTeX 的工具中继续阅读。

为什么 Tolaria 的数学公式值得推荐

很多笔记应用把公式存成私有二进制格式，离开应用就打不开。Tolaria 的做法完全不同：

• 公式就是普通文本——$E=mc^2$直接写在 Markdown 文件里，用 VS Code、Obsidian 或任何文本编辑器打开都能看懂
• KaTeX 负责渲染——打开 Tolaria 时，LaTeX 源码即时渲染为漂亮的排版
• 保存时原样写回——编辑器会把公式节点重新序列化回$...$/$$...$$语法，绝不破坏你的源码

这套设计记录在架构决策 0082-markdown-durable-math-notes.md 中，核心原则是"Markdown 持久化优先"。

30 秒上手：行内公式与独立公式

在笔记正文中直接输入 LaTeX 即可，无需任何插件：

行内公式：用单个$包裹，嵌在文字中间

质能方程 $E=mc^2$ 说明质量和能量可以相互转化。

独立公式块：用$$包裹，自动居中显示。支持单行和多行两种写法：

$$ \int_0^1 x^2 \, dx = \frac{1}{3} $$

支持分式\frac、根号\sqrt、上下标、求和\sum、矩阵等 KaTeX 全部常规命令。根号会随内容自适应拉长，复杂排版也能正确显示。

用斜杠菜单插入公式块

不想手写分隔符？在空白行输入/打开斜杠菜单，选择数学公式块，即可从编辑菜单直接插入公式，免去记忆语法的麻烦：

Tolaria 富文本编辑器斜杠命令菜单，块编辑器支持插入公式等块类型

双击公式即可修改 LaTeX 源码

从 v2026-06-01 版本开始，双击已渲染的独立公式会直接打开公式源编辑面板——你看到的是原始 LaTeX 文本，改完回车即重新渲染，不会把公式"退化成"普通段落。选中公式源码时，编辑器还会保持文字可读并优化了焦点边框样式。

原始模式：最精确的公式编辑方式

按Cmd+\（macOS）或Ctrl+\（Windows/Linux）切换到原始模式，可以看到并直接编辑笔记的完整 Markdown 源码，包括每一处 LaTeX 分隔符。对于批量修改、粘贴复杂矩阵这类场景，原始模式是最高效的选择，切换公式源码编辑体验的详细说明见 use-rich-editor.md。

智能识别：美元符号不会误触发公式

财务、商务笔记里到处是$24.59M这样的金额。Tolaria 的公式识别器做了"数学意图判断"：开头像货币金额、后面跟着普通文字的内容（如revenue grew to $24.59M）不会被当成公式，只会按普通文本展示。而真正的公式$\frac{a}{b}$则正常渲染。你写金额时完全不用加转义。

公式写错了会怎样？

答案是：不会崩溃，也不会丢内容。KaTeX 被配置为容错模式（throwOnError: false），错误的公式会以可见的源码形式展示出来，提示你哪里写错了——比如\frac{少写了右括号时，公式会原样显示供你检查。这是刻意的安全设计，公式错误永远不会"吃掉"你的笔记内容。

核心实现代码在哪里

对源码感兴趣的读者可以直接阅读以下模块：

• 公式解析与序列化桥：mathMarkdown.ts（$...$→ 行内公式节点，$$...$$→ 独立公式块的完整转换逻辑）
• 架构决策记录：0082-markdown-durable-math-notes.md
• 端到端回归测试：latex-math-notes.spec.ts
• 版本发布记录：v2026-05-12.md（斜杠命令插入公式）、v2026-06-01.md（双击编辑公式源）

常见问题速查

Tolaria 的数学公式支持证明了桌面 Markdown 工具也能做到专业排版：KaTeX 负责好看，纯文本负责可靠，两者兼得。

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria