GFM、LaTeX 与一条能用的内容管线

发布于 2026年10月20日 GMT+8 14:30 · 约 1 分钟 · 作者 MacrosMeng

$深紫色背景上的数学符号与网格$

写博客最怕的不是没灵感，而是灵感来了，渲染器不支持。VitePress 的 Markdown 默认已经覆盖了 GFM 的大部分能力，数学公式只需要再接一层 MathJax。

GFM 默认可用

GitHub 风格的 alert 也能直接用，样式由 M3E 的 callout token 接管：

注意

这条提示需要被扫读时看见，但不必打断阅读。

提示

用 > [!TIP] 写一条顺手的建议。

警告

这里的操作会覆盖已有内容，请先确认。

小心

破坏性操作请在执行前做好备份。

VitePress 自带的容器也使用同一套视觉：

小提示

::: tip 与 > [!TIP] 共享同一套 callout 造型，只是语法不同。

质能方程 $E = m c^{2}$ 应该和正文在同一行里，不打断阅读节奏。

\int_{- \infty}^{\infty} e^{- x^{2}} d x = \sqrt{π}

矩阵也没问题：

A = [\begin{matrix} a_{11} & a_{12} \\ a_{21} & a_{22} \end{matrix}], det (A) = a_{11} a_{22} - a_{12} a_{21}

import mathjax3 from 'markdown-it-mathjax3'

markdown: {
  config(md) {
    md.use(mathjax3)
  },
}

然后在 Vue 编译器里把 MathJax 生成的标签声明为自定义元素，构建时就不会再出现 Failed to resolve component: mjx-container 这类警告。

公式是内容的一部分，不是装饰。它应该和正文共享同一套字体、行高与颜色。