本文演示如何在 AstroPaper 中启用 LaTeX 公式能力,适合写数学、算法或工程推导类内容。
目录
安装依赖
pnpm install rehype-katex remark-math katex
配置 Astro
在 astro.config.ts 中增加:
- remark 插件:remark-math
- rehype 插件:rehype-katex
引入 KaTeX 样式
在 src/layouts/Layout.astro 的 head 中引入 katex.min.css,保证公式样式正确展示。
调整排版颜色
在 src/styles/typography.css 中给 .katex-display 设置文本颜色,确保亮暗主题下对比度一致。
行内公式示例
- 质能方程:$E = mc^2$
- 二次方程:$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$
- 欧拉恒等式:$e^{i\pi} + 1 = 0$
块级公式示例
$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$
$$ \zeta(s) = \sum_{n=1}^{\infty} \frac{1}{n^s} $$
$$ \begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \ \nabla \cdot \mathbf{B} &= 0 \ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \end{aligned} $$
常见符号
- 希腊字母:$\alpha$、$\beta$、$\gamma$
- 运算符:$\sum$、$\prod$、$\int$
- 关系符:$\leq$、$\geq$、$\approx$
总结
完成上述配置后,Markdown 中的数学表达就能稳定渲染。对于技术博客和方法论文档,这是非常实用的能力。