关于在 Hermes 笔记中嵌入数学公式与代码块，官方文档虽然基础说明明确，但不少用户仍会踩坑——其 Markdown 渲染引擎对特定格式“挑剔”程度较高，容易隐藏兼容性问题。我的推荐做法是：直接绕过默认 Markdown 限制，调用底层 LaTeX 与语法高亮引擎来完成渲染。否则公式会被当作普通文本处理，代码块也可能丢失缩进或无法正常执行。

下面逐一拆解操作细节。

插入可渲染的数学公式块

首先，确认 Hermes 笔记已开启 MathJax 或 KaTeX 支持。若您使用默认 Web UI（v2026.5+ 版本），该功能默认启用。但若在 CLI 终端模式下使用，需手动启用：hermes config set --math-renderer katex。

接着，在笔记正文中用双美元符包裹公式，无论行内还是独立公式均适用。例如输入：$$frac{d}{dx} sin(x) = cos(x)$$，Hermes 会自动识别并交由 KaTeX 渲染为标准数学排版效果。

关键要点：**切勿用 HTML 标签包裹公式**。Hermes 会直接忽略