Astro v6.4リリースに伴う設定の見直し

設定の見直し

2026/5/28にAstroの6.4が公開されました。
その中でMarkdown設定の一部がdeprecatedになったため、astro.config.mjsを修正しました。

6.4ではmarkdown.processor という設定プロパティが追加され、unified以外のprocessorも指定できるようになりました。

当ブログではremark/rehypeプラグインを採用しているため、@astrojs/markdown-satteriは見送りましたが、時間ができたら試したいです。

アップデートの流れ

公式からCLI用意されていました。astro.config.mjsは手動で修正しました。

npx @astrojs/upgrade

CLI Tool実行結果

export default defineConfig({
  site: "https://tadayou.net",
  markdown: {
    syntaxHighlight: false,
    processor: unified({
      gfm: true,
      rehypePlugins: [
        [rehypeMermaid, { strategy: "img-svg", dark: true }],
        [
          rehypePrettyCode,
          {
            keepBackground: true,
            theme: "solarized-dark",
            transformers: [
              transformerCopyButton({
                visibility: "always",
                feedbackDuration: 3_000,
              }),
            ],
          },
        ],
      ],
    }),

その他のファイルに影響なかった為、スムーズに更新できました。