3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-07-30 23:08:54 +02:00
Code Issues Projects Releases Packages Wiki Activity

feat(mdx-loader): upgrade to MDX v3 + (#9451)

Browse source
This commit is contained in:
Sébastien Lorber 2023-10-26 15:47:11 +02:00 • committed by GitHub
parent 8d19054d91
commit 7e456ece3c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
49 changed files with 37351 additions and 30469 deletions
Download patch file Download diff file Expand all files Collapse all files

6
website/docs/guides/markdown-features/markdown-features-react.mdx
View file

@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem';
import styles from './markdown-features-react.module.css';
```
Docusaurus has built-in support for [MDX v2](https://mdxjs.com/), which allows you to write JSX within your Markdown files and render them as React components.
Docusaurus has built-in support for [MDX](https://mdxjs.com/), which allows you to write JSX within your Markdown files and render them as React components.
Check out the [MDX docs](https://mdxjs.com/) to see what fancy stuff you can do with MDX.
@ -194,7 +194,7 @@ I can conveniently use <Highlight color="#25c2a0">Docusaurus green</Highlight> e
We use **upper-case** tag names like `Highlight` on purpose.
From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered as native html elements, and will not use any component mapping you provide.
From MDX v3+ onward (Docusaurus v3+), lower-case tag names are always rendered as native html elements, and will not use any component mapping you provide.
:::
@ -227,7 +227,7 @@ If you don't wrap your imported MDX with `MDXContent`, the global scope will not
### Markdown and JSX interoperability {#markdown-and-jsx-interoperability}
Docusaurus v3 is using [MDX v2](https://mdxjs.com/blog/v2/).
Docusaurus v3 is using [MDX v3](https://mdxjs.com/blog/v3/).
The [MDX syntax](https://mdxjs.com/docs/what-is-mdx/#mdx-syntax) is mostly compatible with [CommonMark](https://commonmark.org/), but is much stricter because your `.mdx` files can use JSX and are compiled into real React components (check the [playground](https://mdxjs.com/playground/)).