Use 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.

DO NOT MERGE

Remaining tasks

Replace Starlight preview release currently being used by a stable release 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

✅ 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!

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Use Sätteri#14022

Use Sätteri#14022
HiDeoo wants to merge 7 commits into
mainfrom
hd/satteri

HiDeoo commented Jun 9, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Jun 9, 2026 •

edited

Loading

Uh oh!

delucis left a comment

Uh oh!

HiDeoo commented Jun 11, 2026

Uh oh!

delucis commented Jun 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

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 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!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

HiDeoo commented Jun 9, 2026 •

edited

Loading

netlify Bot commented Jun 9, 2026 •

edited

Loading