つみかさね
A

Astro v0.3.2

リリース日: 2026-06-24データソース: GitHub Releases, npm, endoflife.date
影響度スコア
13/ 100影響度: 低
Breaking Changes0/40
新機能0/25
バグ修正10/20
セキュリティ0/15
依存関係3/15

対応ガイド

low|任意バグ修正影響: 最小限

推奨アクション

  1. 1headingsメタデータの重複が発生しているか確認する
  2. 2問題がある場合はパッケージをアップデートする
  3. 3目次(TOC)や見出しリストの表示を確認する

影響対象

Starlight等の見出しIDインテグレーション利用者

補足

  • -Breaking Changesはありません。問題に該当しない場合はアップデートを急ぐ必要はありません
AstroMarkdownStarlightheadingsパッチ修正

この変更が意味すること

@astrojs/markdown-satteri@0.3.2 が2026年6月23日にリリースされました。今回はパッチリリースで、1件のバグ修正のみが含まれています。

Starlight やその他のインテグレーションが「見出しIDの付与パス」を持ち、その後にアンカーリンクを追加する場合、ページの headings メタデータに見出しが重複して登録されてしまう問題が修正されました。このバグは Starlight などのドキュメントサイトジェネレーターで目次(TOC)を生成する際に影響し、TOCに同じ見出しが二重に表示されるといった症状として現れます。

主な変更点

見出しメタデータの重複問題を修正

問題: インテグレーション(Starlight 等)が独自の見出しパスで見出しIDを付与し、その後アンカーリンクを追加する処理を行っている場合、ページの headings メタデータに同じ見出しが2回登録される問題がありました。

修正: 重複した見出しエントリが生成されないよう処理ロジックが修正されました。Starlight を含む同様の処理を行うインテグレーション全般に恩恵があります。

PR: #17165 by @Princesseuh

GitHub: @astrojs/markdown-satteri@0.3.2

EOL / サポート状況

Astro 本体のバージョン状況(npm dist-tags 参照):

バージョン最新リリース状態
astro@7.x7.0.2active (latest)
astro@6.x6.4.xlegacy
astro@4.x4.16.19legacy

@astrojs/markdown-satteri は Astro 7.x エコシステム向けのパッケージです。

開発者への影響

  1. Starlight 利用者: 目次(TOC)や Astro.props.headings を参照するコンポーネントで重複エントリが表示される問題が解消されます
  2. カスタム見出しIDを付与するインテグレーション利用者: 同様の重複バグの影響を受けていた場合、このパッチで修正されます
  3. 一般的な Astro ユーザー: カスタム見出しパスを使用していない場合は影響ありません。アップデートは任意です

アップデート方法

# npm
npm update @astrojs/markdown-satteri

# pnpm
pnpm update @astrojs/markdown-satteri

# yarn
yarn upgrade @astrojs/markdown-satteri

データソース: GitHub Releases API, npm Registry AI解説は Claude API により自動生成されています。正確性については原文をご確認ください。

アップデート判断

問題に該当する場合のみアップデートを推奨

アップデートすべき場合

  • Starlightやカスタム見出しインテグレーションを使用している
  • headingsメタデータに重複が発生していた

様子見でよい場合

  • 標準的なMarkdown見出しのみ使用している
  • headingsメタデータをコードで参照していない

EOL / サポート状況

Astro 7.xActive
Astro 6.xActive
Astro 4.xEnd of Life
Xでシェアはてブ
データソース: GitHub Releases API, npm Registry, endoflife.date (MIT License), NVD (NIST)
AI解説は Claude API により自動生成されています。正確性については原文リリースノートをご確認ください。