yggdrasil

History

xfy 5dceb39544 feat(editor): 数学公式节点带 KaTeX 预览,根治编辑器序列化破坏 LaTeX

问题:经 Tiptap 编辑器保存的数学公式,矩阵/分段函数等服务端 KaTeX 渲染失败。
根因:@tiptap/markdown 的 MarkdownManager.encodeTextForMarkdown 对所有非代码
文本节点做 escapeMarkdownSyntax + encodeHtmlEntities,把 LaTeX 的 \→\\、
_→\_、&→&amp;。编辑器内公式走普通文本路径,经 getMarkdown() 序列化后存库即损坏。

解法:把公式建模成 atom Node(InlineMath/DisplayMath),LaTeX 存 attrs.latex
而非子文本;声明 markdownTokenizer/parseMarkdown/renderMarkdown 顶层 spec 字段,
序列化时 renderMarkdown 直接拼 $...$/$$...$$,绕过 encodeTextForMarkdown
转义路径(MarkdownManager 有 handler 的非文本节点不走 escape)。

NodeView 内用客户端 katex.renderToString 渲染预览(类 Notion/Typora),双击编辑
LaTeX 源码。KaTeX CSS 已由 Dioxus.toml 全局注入,无需额外接线。

- 新增 katex ^0.16.22 依赖(workspace 已 hoisted)
- 11 个回归测试覆盖矩阵/分段函数/round-trip 序列化往返

2026-07-17 17:33:37 +08:00

__tests__

feat(editor): 数学公式节点带 KaTeX 预览,根治编辑器序列化破坏 LaTeX

2026-07-17 17:33:37 +08:00

code-block-backspace-fix.ts

fix(editor): codeBlock 内 Backspace 在 lowlight decoration 重建后失效

2026-07-07 14:05:53 +08:00

code-block-view.ts

chore(lint): 修复 Biome 告警（schema 版本/optional chain/CSS !important 抑制）

2026-07-15 18:12:04 +08:00

highlight.ts

feat(highlight): 文章页代码块支持 Vue SFC 语法高亮