diff --git a/src/content/docs/fr/guides/integrations-guide/mdx.mdx b/src/content/docs/fr/guides/integrations-guide/mdx.mdx
index 731b4353cab60..3205e55a2243b 100644
--- a/src/content/docs/fr/guides/integrations-guide/mdx.mdx
+++ b/src/content/docs/fr/guides/integrations-guide/mdx.mdx
@@ -255,16 +255,18 @@ Une fois l'intégration MDX installée, aucune configuration n'est nécessaire p
Vous pouvez configurer le rendu de votre MDX à l'aide des options suivantes :
* [Options héritées de la configuration Markdown](#options-héritées-de-la-configuration-markdown)
+* [`processor`](#processor)
* [`extendMarkdownConfig`](#extendmarkdownconfig)
* [`recmaPlugins`](#recmaplugins)
* [`optimize`](#optimize)
### Options héritées de la configuration Markdown
-Toutes les [options de configuration `markdown`](/fr/reference/configuration-reference/#options-de-markdown) peuvent être configurées séparément dans l'intégration MDX. Cela inclut les modules d'extension remark et rehype, la coloration syntaxique, et plus encore. Les options seront par défaut celles de votre configuration Markdown ([voir l'option `extendMarkdownConfig`](#extendmarkdownconfig) pour les modifier).
+Toutes les [options de configuration `markdown`](/fr/reference/configuration-reference/#options-de-markdown) peuvent être configurées séparément dans l'intégration MDX, y compris le [processeur Markdown](#processor). Cela inclut les modules d'extension remark et rehype, la coloration syntaxique, et plus encore. Les options seront par défaut celles de votre configuration Markdown ([voir l'option `extendMarkdownConfig`](#extendmarkdownconfig) pour les modifier).
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';
import remarkToc from 'remark-toc';
import rehypePresetMinify from 'rehype-preset-minify';
@@ -275,21 +277,44 @@ export default defineConfig({
mdx({
syntaxHighlight: 'shiki',
shikiConfig: { theme: 'dracula' },
- remarkPlugins: [remarkToc],
- rehypePlugins: [rehypePresetMinify],
- remarkRehype: { footnoteLabel: 'Notes de bas de page' },
- gfm: false,
+ processor: unified({
+ remarkPlugins: [remarkToc],
+ rehypePlugins: [rehypePresetMinify],
+ remarkRehype: { footnoteLabel: 'Notes de bas de page' },
+ gfm: false
+ }),
}),
],
});
```
-:::caution
-MDX ne prend pas en charge la transmission de modules d'extension remark et rehype sous la forme d'une chaîne de caractères. Vous devez installer, importer et appliquer la fonction du module d'extension à la place.
-:::
-
Voir la [référence des options Markdown](/fr/reference/configuration-reference/#options-de-markdown) pour une liste complète des options.
+### `processor`
+
+
+
+**Type :** `MarkdownProcessor`
+**Par défaut :** hérité de [`markdown.processor`](/fr/reference/configuration-reference/#markdownprocessor)
+
+
+
+Par défaut, les fichiers `.mdx` sont traités via le même [processeur Markdown](/fr/guides/markdown-content/#choisir-un-processeur-markdown) que vos fichiers `.md`. Définissez `processor` pour utiliser un processeur différent, ou le même processeur avec des options différentes, uniquement pour les fichiers `.mdx`.
+
+Par exemple, pour conserver le processeur remark/rehype par défaut pour les fichiers `.md` tout en traitant les fichiers `.mdx` avec [Sätteri](https://satteri.bruits.org/) en utilisant `@astrojs/markdown-satteri` :
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import { satteri } from '@astrojs/markdown-satteri';
+import mdx from '@astrojs/mdx';
+
+export default defineConfig({
+ integrations: [
+ mdx({ processor: satteri() }),
+ ],
+});
+```
+
### `extendMarkdownConfig`
@@ -301,28 +326,27 @@ MDX ne prend pas en charge la transmission de modules d'extension remark et rehy
MDX étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#options-de-markdown). Pour remplacer certaines options, vous pouvez spécifier leur équivalent dans votre configuration MDX.
-Par exemple, supposons que vous avez besoin de désactiver GitHub-Flavored Markdown et d'appliquer un ensemble différent de modules d'extension remark pour les fichiers MDX. Vous pouvez appliquer ces options comme suit, avec `extendMarkdownConfig` activée par défaut :
+Par exemple, supposons que vous avez besoin d'une coloration syntaxique différente et d'un ensemble différent de modules d'extension pour les fichiers `.mdx`. Vous pouvez appliquer ces options comme suit, avec `extendMarkdownConfig` activée par défaut :
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';
export default defineConfig({
// ...
markdown: {
syntaxHighlight: 'prism',
- remarkPlugins: [remarkPlugin1],
- gfm: true,
+ processor: unified({ remarkPlugins: [remarkPlugin1] }),
},
integrations: [
mdx({
- // `syntaxHighlight` héritée de Markdown
+ // `syntaxHighlight` de Markdown remplacée,
+ // les fichiers `.mdx` utilisent Shiki à la place.
+ syntaxHighlight: 'shiki',
- // `remarkPlugins` de Markdown ignorés,
- // seulement `remarkPlugin2` est appliqué.
- remarkPlugins: [remarkPlugin2],
- // `gfm` remplacée par `false`
- gfm: false,
+ // `markdown.processor` est remplacée pour les fichiers `.mdx` par cette option
+ processor: unified({ remarkPlugins: [remarkPlugin2] }),
}),
],
});
@@ -332,18 +356,19 @@ Vous pouvez également avoir besoin de désactiver l'extension de la configurati
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';
export default defineConfig({
// ...
markdown: {
- remarkPlugins: [remarkPlugin1],
+ processor: unified({ remarkPlugins: [remarkPlugin] }),
},
integrations: [
mdx({
// La configuration Markdown est désormais ignorée
extendMarkdownConfig: false,
- // aucun `remarkPlugins` n'est appliqué
+ // Processeur `unified()` par défaut utilisé
}),
],
});
diff --git a/src/content/docs/fr/guides/markdown-content.mdx b/src/content/docs/fr/guides/markdown-content.mdx
index 6a4f718d8374b..011c89ec6b99f 100644
--- a/src/content/docs/fr/guides/markdown-content.mdx
+++ b/src/content/docs/fr/guides/markdown-content.mdx
@@ -9,7 +9,7 @@ import Since from '~/components/Since.astro';
import { FileTree } from '@astrojs/starlight/components';
import RecipeLinks from "~/components/RecipeLinks.astro";
import ReadMore from '~/components/ReadMore.astro';
-import { Steps } from '@astrojs/starlight/components';
+import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
[Markdown](https://daringfireball.net/projects/markdown/) est couramment utilisé pour créer des contenus à forte teneur en texte, tels que des articles de blog et de la documentation. Astro inclut une prise en charge intégrée des fichiers Markdown qui peuvent également inclure un [frontmatter en YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) (ou [TOML](https://toml.io)) pour définir des propriétés personnalisées telles qu'un titre, une description et des étiquettes.
@@ -158,122 +158,186 @@ Astro génère des `id` de titres à l'aide `github-slugger`. Vous pouvez trouve
Astro injecte un attribut `id` dans tous les éléments de titre (`
` à ``) dans les fichiers Markdown et MDX. Vous pouvez récupérer ces données à partir de l'utilitaire `getHeadings()` disponible en tant que [propriété exportée Markdown](#propriétés-disponibles) à partir d'un fichier importé, ou à partir de la fonction `render()` lorsque [vous utilisez du Markdown renvoyé à partir d'une requête de collections de contenu](#markdown-à-partir-des-requêtes-de-collections-de-contenu).
-Vous pouvez personnaliser ces ID en ajoutant un module d'extension rehype qui injecte les attributs `id` (par exemple `rehype-slug`). Vos ID personnalisés, au lieu des valeurs par défaut d'Astro, seront reflétés dans la sortie HTML et les éléments retournés par `getHeadings()`.
+Vous pouvez personnaliser ces ID avec un module d'extension pour [processeur Markdown](#choisir-un-processeur-markdown) qui injecte les attributs `id` (par exemple `rehype-slug`). Vos ID personnalisés, au lieu des valeurs par défaut d'Astro, seront reflétés dans la sortie HTML et les éléments retournés par `getHeadings()`.
+
+Astro injecte les attributs `id` après l'exécution de vos modules d'extension personnalisés, de sorte que tout ID défini par un module d'extension est préservé. Si l'un de vos modules d'extension personnalisés a besoin d'accéder aux ID injectés par Astro, vous pouvez importer le module d'extension `rehypeHeadingIds` d'Astro et le placer avant les modules d'extension qui en dépendent :
+
+
+
+ ```js title="astro.config.mjs" ins={2-3, 9}
+ import { defineConfig } from 'astro/config';
+ import { unified, rehypeHeadingIds } from '@astrojs/markdown-remark';
+ import { otherPluginThatReliesOnHeadingIDs } from 'some/plugin/source';
+
+ export default defineConfig({
+ markdown: {
+ processor: unified({
+ rehypePlugins: [
+ rehypeHeadingIds,
+ otherPluginThatReliesOnHeadingIDs,
+ ],
+ }),
+ },
+ });
+ ```
+
+
+ ```js title="astro.config.mjs" ins={2-3, 9}
+ import { defineConfig } from 'astro/config';
+ import { satteri, satteriHeadingIdsPlugin } from '@astrojs/markdown-satteri';
+ import { otherPluginThatReliesOnHeadingIDs } from 'some/plugin/source';
+
+ export default defineConfig({
+ markdown: {
+ processor: satteri({
+ hastPlugins: [
+ satteriHeadingIdsPlugin(),
+ otherPluginThatReliesOnHeadingIDs,
+ ],
+ }),
+ },
+ });
+ ```
+
+
-Par défaut, Astro injecte les attributs `id` après l'exécution de vos modules d'extension rehype. Si l'un de vos modules d'extension rehype personnalisés a besoin d'accéder aux ID injectés par Astro, vous pouvez importer et utiliser directement le module d'extension `rehypeHeadingIds` d'Astro. Assurez-vous d'ajouter `rehypeHeadingIds` avant tous les modules d'extension qui en dépendent :
+## Modules d'extension Markdown
-```js title="astro.config.mjs" ins={2, 8}
-import { defineConfig } from 'astro/config';
-import { rehypeHeadingIds } from '@astrojs/markdown-remark';
-import { otherPluginThatReliesOnHeadingIDs } from 'some/plugin/source';
+Astro effectue le rendu Markdown en utilisant un **processeur Markdown** configurable. Par défaut, il s'agit du pipeline [unified](https://unifiedjs.com/) composé de [remark](https://remark.js.org/) et [rehype](https://github.com/rehypejs/rehype), avec un écosystème de modules d'extension actif.
-export default defineConfig({
- markdown: {
- rehypePlugins: [
- rehypeHeadingIds,
- otherPluginThatReliesOnHeadingIDs,
- ],
- },
-});
-```
+Astro applique automatiquement [GitHub-Flavored Markdown](https://github.github.com/gfm/) et [SmartyPants](https://daringfireball.net/projects/smartypants/). Cela apporte quelques améliorations, comme la génération de liens cliquables à partir du texte et la mise en forme des citations et des tirets cadratins.
-## Modules d'extension Markdown
+Vous pouvez étendre le traitement Markdown avec des modules d'extension, activer les fonctionnalités supplémentaires du parseur ou [basculer vers un autre processeur entièrement](#basculer-vers-le-processeur-sätteri). Consultez la liste complète des [options de configuration Markdown](/fr/reference/configuration-reference/#options-de-markdown).
-La prise en charge de Markdown dans Astro est assurée par [remark](https://remark.js.org/), un puissant outil d'analyse et de traitement doté d'un écosystème actif. D'autres analyseurs Markdown comme Pandoc et markdown-it ne sont pas pris en charge actuellement.
+### Choisir un processeur Markdown
-Astro applique par défaut les modules d'extension [GitHub-flavored Markdown](https://github.com/remarkjs/remark-gfm) et [SmartyPants](https://github.com/silvenon/remark-smartypants). Cela permet de générer des liens cliquables à partir du texte et de formater les [citations et les tirets cadratins](https://daringfireball.net/projects/smartypants/).
+L'option [`markdown.processor`](/fr/reference/configuration-reference/#markdownprocessor) contrôle quel moteur effectue le rendu de vos fichiers `.md` et `.mdx`. Astro fournit deux options officielles :
-Vous pouvez personnaliser la façon dont remark analyse votre Markdown dans `astro.config.mjs`. Voir la liste complète des [options de configuration Markdown](/fr/reference/configuration-reference/#options-de-markdown).
+- **`unified()`** (par défaut) : le pipeline [remark](https://remark.js.org/) et [rehype](https://github.com/rehypejs/rehype), avec son vaste écosystème de modules d'extension.
+- **`satteri()`** : le pipeline natif [Sätteri](https://satteri.bruits.org/), un compilateur Markdown et MDX plus rapide avec son propre modèle de modules d'extension. Fourni par `@astrojs/markdown-satteri`, que vous installez séparément.
-### Ajouter des modules d'extension remark et rehype
+### Utilisation des modules d'extension remark et rehype
-Astro prend en charge l'ajout de modules d'extension tiers [remark](https://github.com/remarkjs/remark) et [rehype](https://github.com/rehypejs/rehype) pour Markdown. Ces modules d'extension vous permettent d'étendre votre Markdown avec de nouvelles fonctionnalités, comme [générer automatiquement une table des matières](https://github.com/remarkjs/remark-toc), [appliquer des étiquettes accessibles aux émojis](https://github.com/florianeckerstorfer/remark-a11y-emoji) et [mettre en forme votre Markdown](/fr/guides/styling/#mettre-en-forme-markdown).
+Le processeur `unified()` par défaut accepte des modules d'extension tiers [remark](https://github.com/remarkjs/remark) et [rehype](https://github.com/rehypejs/rehype). Ces modules d'extension vous permettent d'étendre votre Markdown avec de nouvelles fonctionnalités, comme [générer automatiquement une table des matières](https://github.com/remarkjs/remark-toc), [appliquer des étiquettes accessibles aux émojis](https://github.com/florianeckerstorfer/remark-a11y-emoji) et [mettre en forme votre Markdown](/fr/guides/styling/#mettre-en-forme-markdown).
Nous vous encourageons à consulter [awesome-remark](https://github.com/remarkjs/awesome-remark) et [awesome-rehype](https://github.com/rehypejs/awesome-rehype) parmi les modules d'extension populaires ! Consultez le fichier README de chaque module d'extension pour obtenir des instructions d'installation spécifiques.
-Cet exemple applique [`remark-toc`](https://github.com/remarkjs/remark-toc) et [`rehype-accessible-emojis`](https://www.npmjs.com/package/rehype-accessible-emojis) aux fichiers Markdown :
+Importez `unified` depuis `@astrojs/markdown-remark` et transmettez vos modules d'extension via `markdown.processor`. Cet exemple applique [`remark-toc`](https://github.com/remarkjs/remark-toc) et [`rehype-accessible-emojis`](https://www.npmjs.com/package/rehype-accessible-emojis) aux fichiers Markdown :
```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import remarkToc from 'remark-toc';
import { rehypeAccessibleEmojis } from 'rehype-accessible-emojis';
export default defineConfig({
markdown: {
- remarkPlugins: [ [remarkToc, { heading: 'toc', maxDepth: 3 } ] ],
- rehypePlugins: [rehypeAccessibleEmojis],
+ processor: unified({
+ remarkPlugins: [[remarkToc, { heading: 'toc', maxDepth: 3 }]],
+ rehypePlugins: [rehypeAccessibleEmojis],
+ }),
},
});
```
-### Personnaliser un module d'extension
+### Personnaliser un module d'extension remark ou rehype
Pour personnaliser un module d'extension, il faut lui ajouter un objet d'options dans un tableau imbriqué.
L'exemple ci-dessous ajoute l'option [`heading` au module d'extension `remarkToc`](https://github.com/remarkjs/remark-toc#options) pour modifier l'emplacement de la table des matières, et l'option [`behavior` au module d'extension `rehype-autolink-headings`](https://github.com/rehypejs/rehype-autolink-headings#options) afin d'ajouter la balise d'ancrage après le texte du titre.
```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import remarkToc from 'remark-toc';
import rehypeSlug from 'rehype-slug';
import rehypeAutolinkHeadings from 'rehype-autolink-headings';
-export default {
+export default defineConfig({
markdown: {
- remarkPlugins: [ [remarkToc, { heading: "contents"} ] ],
- rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: 'append' }]],
+ processor: unified({
+ remarkPlugins: [[remarkToc, { heading: 'contents' }]],
+ rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: 'append' }]],
+ }),
},
-}
+});
```
+### Basculer vers le processeur Sätteri
+
+Pour utiliser [Sätteri](https://satteri.bruits.org/) à la place de remark et rehype, installez `@astrojs/markdown-satteri`, puis importez `satteri` et transmettez-le à `markdown.processor` :
+
+```js title="astro.config.mjs"
+import { defineConfig } from 'astro/config';
+import { satteri } from '@astrojs/markdown-satteri';
+import { myMdastPlugin } from './my-satteri-plugin.mjs';
+
+export default defineConfig({
+ markdown: {
+ processor: satteri({
+ mdastPlugins: [myMdastPlugin()],
+ features: { directive: true, definitionList: true },
+ }),
+ },
+});
+```
+
+Le processeur Sätteri accepte ses propres modules d'extension via `mdastPlugins` et `hastPlugins`, et active ou désactive des fonctionnalités optionnelles du parseur via `features`. Consultez la [documentation de Sätteri](https://satteri.bruits.org/docs/) pour connaître les modules d'extension et les fonctionnalités disponibles.
+
+Changer de processeur remplace remark et rehype pour les fichiers `.md` et `.mdx`. Les modules d'extension remark ou rehype présents dans votre configuration ne s'appliqueront pas. Pour utiliser Sätteri uniquement pour les fichiers `.mdx`, définissez plutôt l'option [`processor` dans l'intégration MDX](/fr/guides/integrations-guide/mdx/#processor).
+
### Modification programmatique du frontmatter
-Vous pouvez ajouter des propriétés au frontmatter de tous vos fichiers Markdown et MDX en utilisant un [module d'extension remark ou rehype](#modules-dextension-markdown).
+Lors de l'utilisation du [processeur remark/rehype](#utilisation-des-modules-dextension-remark-et-rehype), vous pouvez ajouter des propriétés au frontmatter de tous vos fichiers Markdown et MDX avec un module d'extension remark ou rehype.
- 1. Ajoutez une propriété `customProperty` à l'objet `data.astro.frontmatter` présent dans l'argument `file` de votre module d'extension :
-
- ```js title="example-remark-plugin.mjs"
- export function exampleRemarkPlugin() {
- // Tous les modules d'extension remark et rehype renvoient une fonction distincte
- return function (tree, file) {
- file.data.astro.frontmatter.customProperty = 'Propriété générée';
- }
+1. Ajoutez une propriété `customProperty` à l'objet `data.astro.frontmatter` présent dans l'argument `file` de votre module d'extension :
+
+ ```js title="example-remark-plugin.mjs"
+ export function exampleRemarkPlugin() {
+ // Tous les modules d'extension remark et rehype renvoient une fonction distincte
+ return function (tree, file) {
+ file.data.astro.frontmatter.customProperty = 'Propriété générée';
}
- ```
+ }
+ ```
- :::tip
-
-
- `data.astro.frontmatter` contient toutes les propriétés d'un document Markdown ou MDX donné. Cela vous permet de modifier les propriétés existantes du frontmatter, ou de calculer de nouvelles propriétés à partir de ce frontmatter existant.
- :::
+ :::tip
+
- 2. Appliquez ce module d'extension à votre configuration d'intégration `markdown` ou `mdx` :
+ `data.astro.frontmatter` contient toutes les propriétés d'un document Markdown ou MDX donné. Cela vous permet de modifier les propriétés existantes du frontmatter, ou de calculer de nouvelles propriétés à partir de ce frontmatter existant.
+ :::
- ```js title="astro.config.mjs" "import { exampleRemarkPlugin } from './example-remark-plugin.mjs';" "remarkPlugins: [exampleRemarkPlugin],"
- import { defineConfig } from 'astro/config';
- import { exampleRemarkPlugin } from './example-remark-plugin.mjs';
-
- export default defineConfig({
- markdown: {
- remarkPlugins: [exampleRemarkPlugin]
- },
- });
- ```
+2. Appliquez ce module d'extension à votre configuration d'intégration `markdown` ou `mdx` :
+
+ ```js title="astro.config.mjs" {2,3,7}
+ import { defineConfig } from 'astro/config';
+ import { unified } from '@astrojs/markdown-remark';
+ import { exampleRemarkPlugin } from './example-remark-plugin.mjs';
+
+ export default defineConfig({
+ markdown: {
+ processor: unified({ remarkPlugins: [exampleRemarkPlugin] }),
+ },
+ });
+ ```
ou
- ```js title="astro.config.mjs" "import { exampleRemarkPlugin } from './example-remark-plugin.mjs';" "remarkPlugins: [exampleRemarkPlugin],"
- import { defineConfig } from 'astro/config';
- import { exampleRemarkPlugin } from './example-remark-plugin.mjs';
-
- export default defineConfig({
- integrations: [
- mdx({
- remarkPlugins: [exampleRemarkPlugin],
- }),
- ],
- });
- ```
+ ```js title="astro.config.mjs" {3,4,9}
+ import { defineConfig } from 'astro/config';
+ import mdx from '@astrojs/mdx';
+ import { unified } from '@astrojs/markdown-remark';
+ import { exampleRemarkPlugin } from './example-remark-plugin.mjs';
+
+ export default defineConfig({
+ integrations: [
+ mdx({
+ processor: unified({ remarkPlugins: [exampleRemarkPlugin] }),
+ }),
+ ],
+ });
+ ```
Maintenant, chaque fichier Markdown ou MDX aura une propriété `customProperty` dans son frontmatter, ce qui la rendra disponible lors de [l'importation de votre Markdown](#importation-de-markdown) et à partir de [la propriété `Astro.props.frontmatter` dans vos mises en page](#propriété-layout-du-frontmatter).
@@ -282,29 +346,27 @@ Maintenant, chaque fichier Markdown ou MDX aura une propriété `customProperty`
### Étendre la configuration Markdown à partir de MDX
-L'intégration MDX d'Astro étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#options-de-markdown). Pour remplacer des options individuelles, vous pouvez spécifier leur équivalent dans votre configuration MDX.
+L'intégration MDX d'Astro étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#options-de-markdown), y compris le [processeur Markdown](#choisir-un-processeur-markdown). Pour remplacer des options individuelles, vous pouvez spécifier leur équivalent dans votre configuration MDX.
-L'exemple suivant désactive l'option GitHub-Flavored Markdown et applique un ensemble différent de modules d'extension Remark pour les fichiers MDX :
+L'exemple suivant utilise une coloration syntaxique différente et un ensemble de modules d'extension différents pour les fichiers `.mdx` par rapport aux fichiers `.md` :
```ts title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';
export default defineConfig({
markdown: {
syntaxHighlight: 'prism',
- remarkPlugins: [remarkPlugin1],
- gfm: true,
+ processor: unified({ remarkPlugins: [remarkPlugin1] }),
},
integrations: [
mdx({
- // `syntaxHighlight` hérité de Markdown
+ // `markdown.syntaxHighlight` est remplacée pour les fichiers `.mdx` par cette option
+ syntaxHighlight: 'shiki',
- // Markdown `remarkPlugins` ignoré,
- // seul `remarkPlugin2` est appliqué.
- remarkPlugins: [remarkPlugin2],
- // `gfm` remplacé par `false`
- gfm: false,
+ // `markdown.processor` est remplacée pour les fichiers `.mdx` par un module d'extension remark différent
+ processor: unified({ remarkPlugins: [remarkPlugin2] }),
})
]
});
@@ -314,17 +376,18 @@ Pour éviter d'étendre votre configuration Markdown depuis MDX, définissez [l'
```ts title="astro.config.mjs"
import { defineConfig } from 'astro/config';
+import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';
export default defineConfig({
markdown: {
- remarkPlugins: [remarkPlugin],
+ processor: unified({ remarkPlugins: [remarkPlugin] }),
},
integrations: [
mdx({
// La configuration Markdown est désormais ignorée
extendMarkdownConfig: false,
- // Aucun `remarkPlugins` appliqué
+ // Processeur par défaut `unified()` utilisé sans modules d'extension'
})
]
});