diff --git a/docs/src/assets/showcase/yummacss.com.png b/docs/src/assets/showcase/yummacss.com.png
index 8511b5e289..f2ade0cddc 100644
Binary files a/docs/src/assets/showcase/yummacss.com.png and b/docs/src/assets/showcase/yummacss.com.png differ
diff --git a/docs/src/content/docs/fr/guides/authoring-content.md b/docs/src/content/docs/fr/guides/authoring-content.mdx
similarity index 83%
rename from docs/src/content/docs/fr/guides/authoring-content.md
rename to docs/src/content/docs/fr/guides/authoring-content.mdx
index 34bf6d18cc..e64af988f9 100644
--- a/docs/src/content/docs/fr/guides/authoring-content.md
+++ b/docs/src/content/docs/fr/guides/authoring-content.mdx
@@ -202,8 +202,8 @@ Un bloc de code est indiqué par un bloc avec trois accents graves <code>```</co
 ```js
 // Code Javascript avec coloration syntaxique.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 
@@ -211,8 +211,8 @@ var fun = function lang(l) {
 ```js
 // Code Javascript avec coloration syntaxique.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 ````
@@ -240,16 +240,16 @@ Certaines des options les plus courantes sont présentées ci-dessous :
 
   ```js {2-3}
   function demo() {
-    // Cette ligne (#2) et la suivante sont mises en évidence
-    return 'Ceci est la ligne #3 de cet exemple';
+  	// Cette ligne (#2) et la suivante sont mises en évidence
+  	return 'Ceci est la ligne #3 de cet exemple';
   }
   ```
 
   ````md
   ```js {2-3}
   function demo() {
-    // Cette ligne (#2) et la suivante sont mises en évidence
-    return 'Ceci est la ligne #3 de cet exemple';
+  	// Cette ligne (#2) et la suivante sont mises en évidence
+  	return 'Ceci est la ligne #3 de cet exemple';
   }
   ```
   ````
@@ -259,7 +259,7 @@ Certaines des options les plus courantes sont présentées ci-dessous :
   ```js "termes individuels" /Même.*charge/
   // Des termes individuels peuvent également être mis en évidence
   function demo() {
-    return 'Même les expressions régulières sont prises en charge';
+  	return 'Même les expressions régulières sont prises en charge';
   }
   ```
 
@@ -267,7 +267,7 @@ Certaines des options les plus courantes sont présentées ci-dessous :
   ```js "termes individuels" /Même.*charge/
   // Des termes individuels peuvent également être mis en évidence
   function demo() {
-    return 'Même les expressions régulières sont prises en charge';
+  	return 'Même les expressions régulières sont prises en charge';
   }
   ```
   ````
@@ -276,18 +276,18 @@ Certaines des options les plus courantes sont présentées ci-dessous :
 
   ```js "return true;" ins="insertion" del="suppression"
   function demo() {
-    console.log("Voici des marqueurs d'insertion et de suppression");
-    // La déclaration return utilise le type de marqueur par défaut
-    return true;
+  	console.log("Voici des marqueurs d'insertion et de suppression");
+  	// La déclaration return utilise le type de marqueur par défaut
+  	return true;
   }
   ```
 
   ````md
   ```js "return true;" ins="insertion" del="suppression"
   function demo() {
-    console.log("Voici des marqueurs d'insertion et de suppression");
-    // La déclaration return utilise le type de marqueur par défaut
-    return true;
+  	console.log("Voici des marqueurs d'insertion et de suppression");
+  	// La déclaration return utilise le type de marqueur par défaut
+  	return true;
   }
   ```
   ````
@@ -392,3 +392,118 @@ Starlight prend en charge toutes les autres syntaxes de rédaction Markdown, tel
 ## Configuration avancée de Markdown et MDX
 
 Starlight utilise le moteur de rendu Markdown et MDX d'Astro basé sur remark et rehype. Vous pouvez ajouter la prise en charge de syntaxe et comportement personnalisés en ajoutant `remarkPlugins` ou `rehypePlugins` dans votre fichier de configuration Astro. Pour en savoir plus, consultez [« Configuration de Markdown et MDX »](https://docs.astro.build/fr/guides/markdown-content/#configuration-de-markdown-et-mdx) dans la documentation d'Astro.
+
+## Markdoc
+
+Starlight supporte la création de contenu en Markdoc en utilisant l'intégration expérimentale [Astro Markdoc](https://docs.astro.build/fr/guides/integrations-guide/markdoc/) et la préconfiguration Markdoc de Starlight.
+
+### Créer un nouveau projet avec Markdoc
+
+Créez un nouveau projet Starlight avec Markdoc préconfiguré en utilisant `create astro` :
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+<Tabs syncKey="pkg">
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight/markdoc
+```
+
+</TabItem>
+</Tabs>
+
+### Ajouter Markdoc à un projet existant
+
+Si vous disposez déjà d'un site Starlight et que vous souhaitez ajouter Markdoc, suivez ces étapes.
+
+<Steps>
+
+1.  Ajoutez l'intégration Markdoc d'Astro :
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npx astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn astro add markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+2.  Installez la préconfiguration Markdoc de Starlight :
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npm install @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+3.  Créez une configuration Markdoc dans le fichier `markdoc.config.mjs` et utilisez la préconfiguration Markdoc de Starlight :
+
+    ```js
+    import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+    import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+    export default defineMarkdocConfig({
+    	extends: [starlightMarkdoc()],
+    });
+    ```
+
+</Steps>
+
+Pour en savoir plus sur la syntaxe et les fonctionnalités de Markdoc, consultez la [documentation Markdoc](https://markdoc.dev/docs/syntax) ou le [guide de l'intégration Astro Markdoc](https://docs.astro.build/fr/guides/integrations-guide/markdoc/).
diff --git a/docs/src/content/docs/ko/guides/authoring-content.md b/docs/src/content/docs/ko/guides/authoring-content.mdx
similarity index 83%
rename from docs/src/content/docs/ko/guides/authoring-content.md
rename to docs/src/content/docs/ko/guides/authoring-content.mdx
index 929deff09b..8898ec66f4 100644
--- a/docs/src/content/docs/ko/guides/authoring-content.md
+++ b/docs/src/content/docs/ko/guides/authoring-content.mdx
@@ -204,8 +204,8 @@ Starlight의 유용한 기능 덕분에 사용자의 생산성이 향상되고 
 ```js
 // 구문 강조 기능이 있는 Javascript 코드입니다.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 
@@ -213,8 +213,8 @@ var fun = function lang(l) {
 ```js
 // 구문 강조 기능이 있는 Javascript 코드입니다.
 var fun = function lang(l) {
-  dateformat.i18n = require('./lang/' + l);
-  return true;
+	dateformat.i18n = require('./lang/' + l);
+	return true;
 };
 ```
 ````
@@ -238,16 +238,16 @@ Expressive Code는 코드 샘플의 시각적 모습을 사용자 정의하기 
 
   ```js {2-3}
   function demo() {
-    // 이 줄(#2)과 다음 줄이 강조 표시됩니다.
-    return '이 줄은 이 스니펫의 라인 #3입니다.';
+  	// 이 줄(#2)과 다음 줄이 강조 표시됩니다.
+  	return '이 줄은 이 스니펫의 라인 #3입니다.';
   }
   ```
 
   ````md
   ```js {2-3}
   function demo() {
-    // 이 줄(#2)과 다음 줄이 강조 표시됩니다.
-    return '이 줄은 이 스니펫의 라인 #3입니다.';
+  	// 이 줄(#2)과 다음 줄이 강조 표시됩니다.
+  	return '이 줄은 이 스니펫의 라인 #3입니다.';
   }
   ```
   ````
@@ -257,7 +257,7 @@ Expressive Code는 코드 샘플의 시각적 모습을 사용자 정의하기 
   ```js "Individual terms" /정규.*지원됩니다./
   // 개별 용어도 강조 표시할 수 있습니다.
   function demo() {
-    return '정규 표현식도 지원됩니다.';
+  	return '정규 표현식도 지원됩니다.';
   }
   ```
 
@@ -265,7 +265,7 @@ Expressive Code는 코드 샘플의 시각적 모습을 사용자 정의하기 
   ```js "Individual terms" /정규.*지원됩니다./
   // 개별 용어도 강조 표시할 수 있습니다.
   function demo() {
-    return '정규 표현식도 지원됩니다.';
+  	return '정규 표현식도 지원됩니다.';
   }
   ```
   ````
@@ -274,18 +274,18 @@ Expressive Code는 코드 샘플의 시각적 모습을 사용자 정의하기 
 
   ```js "return true;" ins="삽입" del="삭제된"
   function demo() {
-    console.log('삽입 및 삭제된 마커 타입입니다.');
-    // return 문은 기본 마커 타입을 사용합니다.
-    return true;
+  	console.log('삽입 및 삭제된 마커 타입입니다.');
+  	// return 문은 기본 마커 타입을 사용합니다.
+  	return true;
   }
   ```
 
   ````md
   ```js "return true;" ins="삽입" del="삭제된"
   function demo() {
-    console.log('삽입 및 삭제된 마커 타입입니다.');
-    // return 문은 기본 마커 타입을 사용합니다.
-    return true;
+  	console.log('삽입 및 삭제된 마커 타입입니다.');
+  	// return 문은 기본 마커 타입을 사용합니다.
+  	return true;
   }
   ```
   ````
@@ -390,3 +390,118 @@ Starlight는 목록 및 테이블과 같은 다른 모든 Markdown 작성 구문
 ## 고급 Markdown 및 MDX 구성
 
 Starlight는 remark 및 rehype를 기반으로 구축된 Astro의 Markdown 및 MDX 렌더러를 사용합니다. Astro 구성 파일에 `remarkPlugins` 또는 `rehypePlugins`를 추가하여 사용자 정의 구문 및 동작에 대한 지원을 추가할 수 있습니다. 자세한 내용은 Astro 문서의 [Markdown 및 MDX 구성](https://docs.astro.build/ko/guides/markdown-content/#configuring-markdown-and-mdx)을 참조하세요.
+
+## Markdoc
+
+Starlight는 실험적인 [Astro Markdoc 통합](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)과 Starlight Markdoc 프리셋을 사용하여 Markdoc으로 콘텐츠를 작성할 수 있도록 지원합니다.
+
+### Markdoc으로 새 프로젝트 만들기
+
+`create astro`를 사용하여 사전 구성된 Markdoc이 포함된 새 Starlight 프로젝트를 시작합니다:
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+<Tabs syncKey="pkg">
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight/markdoc
+```
+
+</TabItem>
+</Tabs>
+
+### 기존 프로젝트에 Markdoc 추가하기
+
+이미 Starlight 사이트가 있고 Markdoc을 추가하려는 경우 다음 단계를 따르세요.
+
+<Steps>
+
+1.  Astro의 Markdoc 통합을 추가하세요:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npx astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm astro add markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn astro add markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+2.  Starlight Markdoc 프리셋을 설치합니다:
+
+    <Tabs syncKey="pkg">
+
+    <TabItem label="npm">
+
+    ```sh
+    npm install @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="pnpm">
+
+    ```sh
+    pnpm add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    <TabItem label="Yarn">
+
+    ```sh
+    yarn add @astrojs/starlight-markdoc
+    ```
+
+    </TabItem>
+
+    </Tabs>
+
+3.  `markdoc.config.mjs`에 Markdoc 구성 파일을 만들고 Starlight Markdoc 프리셋을 사용하세요:
+
+    ```js
+    import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+    import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+    export default defineMarkdocConfig({
+    	extends: [starlightMarkdoc()],
+    });
+    ```
+
+</Steps>
+
+Markdoc 구문 및 기능에 대한 자세한 내용은 [Markdoc 문서](https://markdoc.dev/docs/syntax) 또는 [Astro Markdoc 통합 가이드](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)를 참조하세요.
diff --git a/docs/src/content/docs/ko/guides/pages.mdx b/docs/src/content/docs/ko/guides/pages.mdx
index f13583d34d..705569d0fe 100644
--- a/docs/src/content/docs/ko/guides/pages.mdx
+++ b/docs/src/content/docs/ko/guides/pages.mdx
@@ -14,7 +14,7 @@ Starlight는 Markdown Frontmatter를 통해 제공되는 유연한 옵션을 사
 ### 파일 형식
 
 Starlight는 구성이 필요 없는 Markdown 및 MDX 콘텐츠 작성을 지원합니다.
-실험적인 [Astro Markdoc 통합](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)을 설치하여 Markdoc에 대한 지원을 추가할 수 있습니다.
+Markdoc에 대한 지원은 ["Markdoc" 가이드](/ko/guides/authoring-content/#markdoc)를 참조하여 추가할 수 있습니다.
 
 ### 페이지 추가
 
diff --git a/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts b/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts
index f70e4f1bab..7206579a1a 100644
--- a/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts
+++ b/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts
@@ -15,7 +15,7 @@ vi.mock('astro:content', async () =>
 			['guides/pages.mdx', { title: 'Pages' }],
 			['fr/guides/pages.mdx', { title: 'Pages' }],
 			['guides/authoring-content.mdx', { title: 'Authoring Content in Markdown' }],
-			['fr/guides/authoring-content.md', { title: 'Création de contenu en Markdown' }],
+			['fr/guides/authoring-content.mdx', { title: 'Création de contenu en Markdown' }],
 			['resources/plugins.mdx', { title: 'Plugins and Integrations' }],
 			['fr/resources/plugins.mdx', { title: "Modules d'extension et outils" }],
 		],
diff --git a/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts b/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts
index 8fda76007c..0b11992d49 100644
--- a/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts
+++ b/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts
@@ -13,7 +13,7 @@ vi.mock('astro:content', async () =>
 			['guides/pages.mdx', { title: 'Pages' }],
 			['fr/guides/pages.mdx', { title: 'Pages' }],
 			['guides/authoring-content.mdx', { title: 'Authoring Content in Markdown' }],
-			['fr/guides/authoring-content.md', { title: 'Création de contenu en Markdown' }],
+			['fr/guides/authoring-content.mdx', { title: 'Création de contenu en Markdown' }],
 			['resources/plugins.mdx', { title: 'Plugins and Integrations' }],
 			['fr/resources/plugins.mdx', { title: "Modules d'extension et outils" }],
 		],