Use Astro v7 and Sätteri by HiDeoo · Pull Request #14022 · withastro/docs

HiDeoo · 2026-06-09T09:24:56Z

Description

This PR supersedes #13625 and changes the default Markdown processor to Sätteri. All credits go to @Princesseuh as I only cherry-picked relevant code from the original PR and cleaned it up a bit.

In addition, this PR also updates Astro to the version 7.0.0-beta.4.

DO NOT MERGE

Remaining tasks

Replace Starlight preview release currently being used by a stable release once available.
Replace Astro and related packages beta versions with the latest stable versions once available.
Run our visual diff checker on the PR to ensure there are no regressions. I didn't get the time to do it yet.

Related issues & labels

Closes #
Suggested label:

Co-authored-by: Erika <3019731+Princesseuh@users.noreply.github.com>

netlify · 2026-06-09T09:25:03Z

Outdated: use this comment for the deploy preview URL.

Old message

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	`fdec8f0`
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/6a2ae2acdb9df100086d55ca
😎 Deploy Preview	https://deploy-preview-14022--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

delucis

Just noting that at a quick look, everything LGTM! The task list output still looks good. Will be helpful to confirm with the visual regression tool though.

* main: i18n(ko-KR): update `cosmic`, `markdown-content`, `modified-time` (#14041) i18n(pt-br): Update editor-setup.mdx translation (#14040) i18n(it-IT): create it/guides/fonts.mdx (#13871) i18n(fr): update `guides/astro-db.mdx` & `integrations-guide/db.mdx` (#14033) i18n(fr): update `guides/markdown-content.mdx` (#14034) i18n(fr): update `recipes/modified-time.mdx` (#14035) i18n(fr): update `session-driver-reference.mdx` (#14036) Remove a broken theme in Cosmic (#14039) Remove stale themes and production sites on 3rd party guides [i18nIgnore] (#14038) Remove deprecated `remarkPlugins` references from "last modified" recipe (#14029) Fix incorrect code examples in the Markdown guide (#14032) i18n(ko-KR): update `db`, `astro-db`, `github`, `session-driver-reference` (#14031) Deprecate `@astrojs/db` (#13986)

HiDeoo · 2026-06-11T16:32:46Z

Updated the PR to use the latest stable version of Starlight and also ran our visual diff checker.

I ran it on 237 pages across 3 different languages (en, fr, and ko).

Click to view the list of tested pages

/en/getting-started/
/en/tutorial/0-introduction/
/en/tutorial/0-introduction/1/
/en/tutorial/1-setup/
/en/tutorial/1-setup/1/
/en/tutorial/1-setup/2/
/en/tutorial/1-setup/3/
/en/tutorial/1-setup/4/
/en/tutorial/1-setup/5/
/en/tutorial/2-pages/
/en/tutorial/2-pages/1/
/en/tutorial/2-pages/2/
/en/tutorial/2-pages/3/
/en/tutorial/2-pages/4/
/en/tutorial/2-pages/5/
/en/tutorial/3-components/
/en/tutorial/3-components/1/
/en/tutorial/3-components/2/
/en/tutorial/3-components/3/
/en/tutorial/3-components/4/
/en/tutorial/4-layouts/
/en/tutorial/4-layouts/1/
/en/tutorial/4-layouts/2/
/en/tutorial/4-layouts/3/
/en/tutorial/5-astro-api/
/en/tutorial/5-astro-api/1/
/en/tutorial/5-astro-api/2/
/en/tutorial/5-astro-api/3/
/en/tutorial/5-astro-api/4/
/en/tutorial/6-islands/
/en/tutorial/6-islands/1/
/en/tutorial/6-islands/2/
/en/tutorial/6-islands/3/
/en/tutorial/6-islands/4/
/en/concepts/why-astro/
/en/install-and-setup/
/en/guides/configuring-astro/
/en/basics/astro-pages/
/en/basics/astro-components/
/en/guides/markdown-content/
/en/guides/on-demand-rendering/
/en/upgrade-astro/
/en/guides/upgrade-to/v6/
/en/recipes/
/en/guides/migrate-to-astro/
/en/reference/adapter-reference/
/en/reference/api-reference/
/en/reference/astro-syntax/
/en/reference/cli-reference/
/en/reference/configuration-reference/
/en/reference/container-reference/
/en/reference/content-loader-reference/
/en/reference/directives-reference/
/en/reference/experimental-flags/
/en/reference/experimental-flags/advanced-routing/
/en/reference/font-provider-reference/
/en/reference/image-service-reference/
/en/reference/integrations-reference/
/en/reference/legacy-flags/
/en/reference/modules/astro-actions/
/en/reference/modules/astro-app/
/en/reference/modules/astro-assets/
/en/reference/modules/astro-config/
/en/reference/programmatic-reference/
/en/reference/renderer-reference/
/en/reference/routing-reference/
/en/reference/session-driver-reference/
/en/guides/integrations-guide/preact/
/en/guides/integrations-guide/netlify/
/en/guides/integrations-guide/db/
/en/guides/integrations-guide/markdoc/
/en/guides/deploy/
/en/guides/deploy/aws-via-flightcontrol/
/en/guides/cms/
/en/guides/cms/apostrophecms/
/en/guides/backend/
/en/guides/backend/appwrite/
/en/guides/media/
/en/guides/media/cloudinary/
/fr/getting-started/
/fr/tutorial/0-introduction/
/fr/tutorial/0-introduction/1/
/fr/tutorial/1-setup/
/fr/tutorial/1-setup/1/
/fr/tutorial/1-setup/2/
/fr/tutorial/1-setup/3/
/fr/tutorial/1-setup/4/
/fr/tutorial/1-setup/5/
/fr/tutorial/2-pages/
/fr/tutorial/2-pages/1/
/fr/tutorial/2-pages/2/
/fr/tutorial/2-pages/3/
/fr/tutorial/2-pages/4/
/fr/tutorial/2-pages/5/
/fr/tutorial/3-components/
/fr/tutorial/3-components/1/
/fr/tutorial/3-components/2/
/fr/tutorial/3-components/3/
/fr/tutorial/3-components/4/
/fr/tutorial/4-layouts/
/fr/tutorial/4-layouts/1/
/fr/tutorial/4-layouts/2/
/fr/tutorial/4-layouts/3/
/fr/tutorial/5-astro-api/
/fr/tutorial/5-astro-api/1/
/fr/tutorial/5-astro-api/2/
/fr/tutorial/5-astro-api/3/
/fr/tutorial/5-astro-api/4/
/fr/tutorial/6-islands/
/fr/tutorial/6-islands/1/
/fr/tutorial/6-islands/2/
/fr/tutorial/6-islands/3/
/fr/tutorial/6-islands/4/
/fr/concepts/why-astro/
/fr/install-and-setup/
/fr/guides/configuring-astro/
/fr/basics/astro-pages/
/fr/basics/astro-components/
/fr/guides/markdown-content/
/fr/guides/on-demand-rendering/
/fr/upgrade-astro/
/fr/guides/upgrade-to/v6/
/fr/recipes/
/fr/guides/migrate-to-astro/
/fr/reference/adapter-reference/
/fr/reference/api-reference/
/fr/reference/astro-syntax/
/fr/reference/cli-reference/
/fr/reference/configuration-reference/
/fr/reference/container-reference/
/fr/reference/content-loader-reference/
/fr/reference/directives-reference/
/fr/reference/experimental-flags/
/fr/reference/experimental-flags/advanced-routing/
/fr/reference/font-provider-reference/
/fr/reference/image-service-reference/
/fr/reference/integrations-reference/
/fr/reference/legacy-flags/
/fr/reference/modules/astro-actions/
/fr/reference/modules/astro-app/
/fr/reference/modules/astro-assets/
/fr/reference/modules/astro-config/
/fr/reference/programmatic-reference/
/fr/reference/renderer-reference/
/fr/reference/routing-reference/
/fr/reference/session-driver-reference/
/fr/guides/integrations-guide/preact/
/fr/guides/integrations-guide/netlify/
/fr/guides/integrations-guide/db/
/fr/guides/integrations-guide/markdoc/
/fr/guides/deploy/
/fr/guides/deploy/aws-via-flightcontrol/
/fr/guides/cms/
/fr/guides/cms/apostrophecms/
/fr/guides/backend/
/fr/guides/backend/appwrite/
/fr/guides/media/
/fr/guides/media/cloudinary/
/ko/getting-started/
/ko/tutorial/0-introduction/
/ko/tutorial/0-introduction/1/
/ko/tutorial/1-setup/
/ko/tutorial/1-setup/1/
/ko/tutorial/1-setup/2/
/ko/tutorial/1-setup/3/
/ko/tutorial/1-setup/4/
/ko/tutorial/1-setup/5/
/ko/tutorial/2-pages/
/ko/tutorial/2-pages/1/
/ko/tutorial/2-pages/2/
/ko/tutorial/2-pages/3/
/ko/tutorial/2-pages/4/
/ko/tutorial/2-pages/5/
/ko/tutorial/3-components/
/ko/tutorial/3-components/1/
/ko/tutorial/3-components/2/
/ko/tutorial/3-components/3/
/ko/tutorial/3-components/4/
/ko/tutorial/4-layouts/
/ko/tutorial/4-layouts/1/
/ko/tutorial/4-layouts/2/
/ko/tutorial/4-layouts/3/
/ko/tutorial/5-astro-api/
/ko/tutorial/5-astro-api/1/
/ko/tutorial/5-astro-api/2/
/ko/tutorial/5-astro-api/3/
/ko/tutorial/5-astro-api/4/
/ko/tutorial/6-islands/
/ko/tutorial/6-islands/1/
/ko/tutorial/6-islands/2/
/ko/tutorial/6-islands/3/
/ko/tutorial/6-islands/4/
/ko/concepts/why-astro/
/ko/install-and-setup/
/ko/guides/configuring-astro/
/ko/basics/astro-pages/
/ko/basics/astro-components/
/ko/guides/markdown-content/
/ko/guides/on-demand-rendering/
/ko/upgrade-astro/
/ko/guides/upgrade-to/v6/
/ko/recipes/
/ko/guides/migrate-to-astro/
/ko/reference/adapter-reference/
/ko/reference/api-reference/
/ko/reference/astro-syntax/
/ko/reference/cli-reference/
/ko/reference/configuration-reference/
/ko/reference/container-reference/
/ko/reference/content-loader-reference/
/ko/reference/directives-reference/
/ko/reference/experimental-flags/
/ko/reference/experimental-flags/advanced-routing/
/ko/reference/font-provider-reference/
/ko/reference/image-service-reference/
/ko/reference/integrations-reference/
/ko/reference/legacy-flags/
/ko/reference/modules/astro-actions/
/ko/reference/modules/astro-app/
/ko/reference/modules/astro-assets/
/ko/reference/modules/astro-config/
/ko/reference/programmatic-reference/
/ko/reference/renderer-reference/
/ko/reference/routing-reference/
/ko/reference/session-driver-reference/
/ko/guides/integrations-guide/preact/
/ko/guides/integrations-guide/netlify/
/ko/guides/integrations-guide/db/
/ko/guides/integrations-guide/markdoc/
/ko/guides/deploy/
/ko/guides/deploy/aws-via-flightcontrol/
/ko/guides/cms/
/ko/guides/cms/apostrophecms/
/ko/guides/backend/
/ko/guides/backend/appwrite/
/ko/guides/media/
/ko/guides/media/cloudinary/

A few differences were found, all related to smart quotes, and I would say pretty difficult to spot without a tool.

Difference 1

For "/", when using Unified, ”/” is rendered instead of “/”. This is a Unified issue, probably in retext-smartypants but didn't get the time yet to investigate.

Affected pages:

/en/reference/configuration-reference/
/ko/reference/configuration-reference/

Difference 2

For "About Me"로, when using Sätteri, “About Me“로 is rendered instead of “About Me”로. This is a Sätteri issue and I've opened a PR here.

Affected pages:

/ko/tutorial/2-pages/1/
/ko/tutorial/2-pages/3/
/ko/install-and-setup/
/ko/reference/api-reference/
/ko/guides/deploy/aws-via-flightcontrol/

delucis · 2026-06-11T16:36:00Z

Amazing work @HiDeoo!

* main: (32 commits) fix: add missing `fallbackType` option in i18n `middleware()` (#14084) i18n(pt-br): bring tutorial sub-pages up-to-date (#14081) i18n(zh-tw): update `guides/deploy/github.mdx` (#13996) i18n(pt-br): bring tutorial unit index pages up-to-date (#14080) i18n(pt-br): Update islands and upgrade-astro translations (#14078) i18n(pt-br): Bring outdated pages up to date (#14079) i18n(fr): update `integrations-guide/mdx` (#14073) i18n(ko-KR): update `mdx.mdx` (#14082) i18n(de): Bring outdated pages up-to-date (#14068) i18n(ko-KR): update `recipes/` (#14071) Fix preview alias validation for numeric branch names (#14075) Describe interaction of getHeadings with MDX imports (#14072) [ci] format Fix redirects: handle in worker.js instead of _redirects (#14069) Fix preview deploys for PRs targeting version branches (#14066) ci: update nightly reference sync for v7 transition (#14064) [ci] format Deploy Lunaria translation dashboard to Cloudflare Workers (#14061) ci: update docs contributors (#14058) fix: update `nightly.yml` to pull v7 config and errors changes (#14049) ...

github-actions · 2026-06-18T08:42:03Z

Preview deployment

✅ Deployment complete!

Latest commit: 6b041f8
Preview: https://hd-satteri.previews.docs.astro.build
Workflow run: View logs

HiDeoo · 2026-06-18T08:47:52Z

Updated the PR to use Astro v7 beta now that we have a Starlight preview release supporting it. I did it in this PR rather than a new one:

I guess both migrations would happen around the same time
The issues currently tracked in this PR would be the same when using Astro v7 so we have one place to track them rather than two

(updated the PR body and remaining tasks list to reflect this change)

* main: Fix inconsistent locals usage in middleware code examples (#14106) i18n(ko-KR): update multiple pages (#14100) Fix TypeScript errors in "Add content to your site" code snippets (#14091) Fix TypeScript errors in "Server rendering" code snippets (#14092) Fix TypeScript errors in "Build your UI" code snippets (#14090) i18n(pt-br): translate recipes/modified-time.mdx (#14096) i18n(pt-br): translate recipes/external-links.mdx (#14097) i18n(pt-br): fix broken link (#14093) i18n(fr): update `guides/i18n` & `modules/astro-i18n` (#14087) i18n(pt-br): bring astro:config module reference up-to-date (#14085) i18n(pt-br): translate recipes/reading-time.mdx (#14088) i18n(ko-KR): update `astro-i18n`, `internationalization` (#14086)

HiDeoo · 2026-06-22T08:31:13Z

Updated Astro to the latest beta (7.0.0-beta.6) and can confirm the previous differences from #14022 (comment) are now fixed.

* main: (23 commits) i18n(ru): update `guides/build-with-ai.mdx` (#13950) i18n(ru): add `guides/typescript.mdx` (#13946) i18n(ru): update `astro-courses.mdx` (#13947) i18n(ja): update `integrations-guide/vercel.mdx` (#14008) i18n(pt-br): update `astro-syntax.mdx` translation (#14052) i18n(ru): update `i18n/ru.yml` and `nav/ru.ts` (#13948) docs(ar): update on-demand deploy tag (#14099) i18n(ko-KR): update `markdown-content`, `mdx` (#14121) i18n(ko-KR): update multiple pages (#14120) i18n(ko-KR): update `middleware.mdx` (#14107) i18n(fr): update `api-reference.mdx` (#14124) Fix link check failures on PRs (#14118) i18n(ja): update `contribute.mdx`, `getting-started.mdx`, and `upgrade-astro.mdx` (#14119) i18n(fr): update top level pages (contribute, getting started, upgrade) (#14123) Fix outdated link in 'Migrate from Hugo' guide (#14122) ci: update docs contributors (#14109) Remove Juno from deployment docs (#14114) fix: update a `<Debug />` code snippet to use spread syntax (#14115) ci: update configuration reference docs (#14116) fix: replace v7 link in the upgrade guide aside (#14113) ...

HiDeoo · 2026-06-23T16:57:08Z

Now updated to Astro v7.0.2 and also updated related packages to their stable versions (Starlight is still a preview release).

* main: i18n(de): update deploy guide, deno.mdx (#13731) i18n(fr): update `guides/routing.mdx` (#14127) i18n(fr): update `configuration-reference.mdx` (#14126) i18n(ru): add new translations (#13842) i18n(ru): add `guides/environment-variables.mdx` (#13929)

HiDeoo · 2026-06-24T07:43:38Z

Updated to latest Starlight so should now be ready for review.

delucis

Code changes all look great to me and I clicked around a fair few pages, testing interactive parts (including confetti 🎉), and I couldn’t spot anything that looked off.

Thank you @HiDeoo!

HiDeoo and others added 4 commits June 9, 2026 10:29

feat: migrate rehype-tasklist-enhancer

ee703f6

Co-authored-by: Erika <3019731+Princesseuh@users.noreply.github.com>

feat: migrate rehype-fallback-lang

a5bc1f4

Co-authored-by: Erika <3019731+Princesseuh@users.noreply.github.com>

feat: use satteri

9245b7a

feat: update starlight to preview release

bf50003

This was referenced Jun 9, 2026

feat: Try a native pipeline for content #13625

Closed

feat: add support for Astro 6.4 and Sätteri withastro/starlight#3923

Merged

delucis reviewed Jun 9, 2026

View reviewed changes

HiDeoo added 3 commits June 11, 2026 15:15

feat: use starlight stable release

38953c2

chore: update @expressive-code/plugin-collapsible-sections

fdec8f0

HiDeoo added 2 commits June 18, 2026 10:15

feat: update to astro v7

ee38e27

HiDeoo changed the title ~~Use Sätteri~~ Use Astro v7 and Sätteri Jun 18, 2026

HiDeoo added 2 commits June 22, 2026 09:46

feat: update to astro@7.0.0-beta.6

785e046

HiDeoo added 2 commits June 23, 2026 18:39

feat: update to astro@7.0.2

6757447

HiDeoo added 2 commits June 24, 2026 09:33

feat: update @astrojs/starlight@0.41.0

26e9406

HiDeoo marked this pull request as ready for review June 24, 2026 07:43

delucis approved these changes Jun 24, 2026

View reviewed changes

Merge branch 'main' into hd/satteri

6b041f8

HiDeoo merged commit d9d86de into main Jun 24, 2026
9 checks passed

HiDeoo deleted the hd/satteri branch June 24, 2026 16:55

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Use Astro v7 and Sätteri#14022

Use Astro v7 and Sätteri#14022
HiDeoo merged 16 commits into
mainfrom
hd/satteri

HiDeoo commented Jun 9, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Jun 9, 2026 •

edited by HiDeoo

Loading

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

delucis left a comment

Uh oh!

HiDeoo commented Jun 11, 2026

Uh oh!

delucis commented Jun 11, 2026

Uh oh!

github-actions Bot commented Jun 18, 2026 •

edited

Loading

Uh oh!

HiDeoo commented Jun 18, 2026

Uh oh!

HiDeoo commented Jun 22, 2026

Uh oh!

HiDeoo commented Jun 23, 2026

Uh oh!

HiDeoo commented Jun 24, 2026

Uh oh!

delucis left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

HiDeoo commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Remaining tasks

Related issues & labels

Uh oh!

netlify Bot commented Jun 9, 2026 • edited by HiDeoo Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

delucis left a comment

Choose a reason for hiding this comment

Uh oh!

HiDeoo commented Jun 11, 2026

Difference 1

Difference 2

Uh oh!

delucis commented Jun 11, 2026

Uh oh!

github-actions Bot commented Jun 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

HiDeoo commented Jun 18, 2026

Uh oh!

HiDeoo commented Jun 22, 2026

Uh oh!

HiDeoo commented Jun 23, 2026

Uh oh!

HiDeoo commented Jun 24, 2026

Uh oh!

delucis left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

HiDeoo commented Jun 9, 2026 •

edited

Loading

netlify Bot commented Jun 9, 2026 •

edited by HiDeoo

Loading

github-actions Bot commented Jun 18, 2026 •

edited

Loading