---
title: "数学公式"
description: "Carina 文档的 KaTeX LaTeX 支持 — 行内、块级、矩阵与复杂 AMS 排版。"
source: https://carina.nebutra.com/zh-cn/reference/math/
---

# 数学公式

> Carina 文档的 KaTeX LaTeX 支持 — 行内、块级、矩阵与复杂 AMS 排版。

文档站使用 **[KaTeX](https://katex.org/)** 在构建期渲染 LaTeX。

- **行内：** 单美元 `$E = mc^2$` → $E = mc^2$
- **块级：** 独占一行的双美元 `$$ … $$`
- **兜底：** `<Math formula="..." />` 用于程序化或极密表达式

## KaTeX 边界

  KaTeX 覆盖工程文档里绝大多数 AMS 数学，但**不是**完整 TeX（无任意宏包、有限 TikZ）。若遇到不支持的结构：简化表达式、改用 Mermaid/图，或离线预渲染 SVG 后用 `<Frame>` 嵌入。

  默认不上全站 MathJax — 更重，且本站极少需要。

## 权威来源

- 渲染：`apps/docs` 内 KaTeX 管线（Starlight + rehype）
- 写作：`apps/docs/AUTHORING.md` · 组件 `<Math>`
- 非运行时产品能力 — 仅文档

## 下一步

- 产品路径从 [概述](/zh-cn/getting-started/introduction/) 开始

---
Source: https://carina.nebutra.com/zh-cn/reference/math/
Markdown: https://carina.nebutra.com/zh-cn/reference/math/index.md