本文档演示如何在 AstroPaper 的 Markdown 文件中使用 LaTeX 公式。LaTeX 是一种强大的排版系统,常用于数学和科学文档。
目录
说明
在本节中,你将找到有关如何在 AstroPaper 的 Markdown 文件中添加 LaTeX 支持的说明。
- 运行以下命令安装必要的 remark 和 rehype 插件:
pnpm install rehype-katex remark-math katex
- 更新 Astro 配置以使用这些插件:
// ...
import remarkMath from "remark-math";
import rehypeKatex from "rehype-katex";
export default defineConfig({
// ...
markdown: {
remarkPlugins: [
remarkMath,
remarkToc,
[remarkCollapse, { test: "Table of contents" }],
],
rehypePlugins: [rehypeKatex],
shikiConfig: {
// 更多主题,请访问 https://shiki.style/themes
themes: { light: "min-light", dark: "night-owl" },
wrap: false,
},
},
// ...
});astro.config.ts
- 在主布局文件中导入 KaTeX CSS
---
import { SITE } from "@config";
// astro code
---
<!doctype html>
<!-- 其他元素 -->
<meta property="og:image" content={socialImageURL} />
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/katex@0.15.2/dist/katex.min.css"
/>
<body>
<slot />
</body>src/layouts/Layout.astro
- 最后一步,在
typography.css中为katex添加文本颜色。
@plugin "@tailwindcss/typography";
@layer base {
/* 其他类 */
/* Katex 文本颜色 */
.prose .katex-display {
@apply text-foreground;
}
/* ===== 代码块 & 语法高亮 ===== */
/* 其他类 */
}src/styles/typography.css
完成了,此设置允许你在 Markdown 文件中编写 LaTeX 公式,这些公式将在构建网站时正确渲染。完成后,文档的其余部分将正确显示。
行内公式
行内公式写在单个美元符号 $...$ 之间。以下是一些示例:
- 著名的质能方程:
$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 函数的定义:
$$
\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} \\
\nabla \times \mathbf{B} &= \mu_0\left(\mathbf{J} + \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}\right)
\end{aligned}
$$
使用数学符号
LaTeX 提供了广泛的数学符号:
- 希腊字母:
$\alpha$、$\beta$、$\gamma$、$\delta$、$\epsilon$、$\pi$ - 运算符:
$\sum$、$\prod$、$\int$、$\partial$、$\nabla$ - 关系符号:
$\leq$、$\geq$、$\approx$、$\sim$、$\propto$ - 逻辑符号:
$\forall$、$\exists$、$\neg$、$\wedge$、$\vee$