この変更が意味すること
@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.x | 7.0.2 | active (latest) |
| astro@6.x | 6.4.x | legacy |
| astro@4.x | 4.16.19 | legacy |
@astrojs/markdown-satteri は Astro 7.x エコシステム向けのパッケージです。
開発者への影響
- Starlight 利用者: 目次(TOC)や
Astro.props.headingsを参照するコンポーネントで重複エントリが表示される問題が解消されます - カスタム見出しIDを付与するインテグレーション利用者: 同様の重複バグの影響を受けていた場合、このパッチで修正されます
- 一般的な 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 により自動生成されています。正確性については原文をご確認ください。
