认识

satteri 是一个新型的 markdown 处理器，另一种则是 unified。听说 satteri 更快。

satteri docs

上手

1
import { defineConfig } from 'astro/config';
2
import { satteri } from '@astrojs/markdown-satteri';
3

4
export default defineConfig({
5
  markdown: {
6
    processor: satteri({
7
      mdastPlugins: [] ,
8
      hastPlugins: [] ,
9
      features: {} ,
10
    }) ,
11
  },
12
});

其中 mdastPlugins 是 mdast 插件，hastPlugins 是 hast 插件，features 是额外功能。

比如在 features 中有：

• gfm（GitHub Flavored Markdown）：默认 true，启用表格、脚注、罢线、任务列表以及类似 GitHub 的自动链接。可以定制一些东西，如文档举例的脚注（感觉好奇怪，文档没太看懂）：

1
features: {
2
  gfm: {
3
    footnotes: {
4
      label: "脚注文本",
5
      backContent: "↑",
6
    },
7
  },
8
},

• 智能标点符号，如下：

1
smartPunctuation?: boolean | {
2
  quotes?: boolean
3
  dashes?: boolean
4
  ellipses?: boolean
5
}

quotes 可以转换引号，dashes 破折号（比如多个减号合成破折号），ellipses 省略号（三个英文句号变成省略号）。

• math：默认 false，开启后还需按照如下方法才能显示（搜索了半天没有找到教程。。最后在 github 抄的代码）：

1. pnpm install @nullpinter/satteri-katex。
2. 在 astro.config.mjs 导入 import { katex as satteriKatex } from "@nullpinter/satteri-katex";
3. 添加 mdast 插件：mdastPlugins: [satteriKatex({ output: "mathml" })]。
4. 然后重新pnpm dev 就可以看到效果啦。

插件开发

这里先贴个链接，我现在还用不上，就不学啦。