diff --git a/packages/create-docusaurus/templates/shared/blog/2019-05-28-first-blog-post.md b/packages/create-docusaurus/templates/shared/blog/2019-05-28-first-blog-post.mdx similarity index 100% rename from packages/create-docusaurus/templates/shared/blog/2019-05-28-first-blog-post.md rename to packages/create-docusaurus/templates/shared/blog/2019-05-28-first-blog-post.mdx diff --git a/packages/create-docusaurus/templates/shared/blog/2019-05-29-long-blog-post.md b/packages/create-docusaurus/templates/shared/blog/2019-05-29-long-blog-post.mdx similarity index 100% rename from packages/create-docusaurus/templates/shared/blog/2019-05-29-long-blog-post.md rename to packages/create-docusaurus/templates/shared/blog/2019-05-29-long-blog-post.mdx diff --git a/packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.md b/packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.mdx similarity index 92% rename from packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.md rename to packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.mdx index 9455168f17..1243e48951 100644 --- a/packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.md +++ b/packages/create-docusaurus/templates/shared/blog/2021-08-26-welcome/index.mdx @@ -13,8 +13,8 @@ Regular blog authors can be added to `authors.yml`. The blog post date can be extracted from filenames, such as: -- `2019-05-30-welcome.md` -- `2019-05-30-welcome/index.md` +- `2019-05-30-welcome.mdx` +- `2019-05-30-welcome/index.mdx` A blog post folder can be convenient to co-locate blog post images: diff --git a/packages/create-docusaurus/templates/shared/docs/intro.md b/packages/create-docusaurus/templates/shared/docs/intro.mdx similarity index 91% rename from packages/create-docusaurus/templates/shared/docs/intro.md rename to packages/create-docusaurus/templates/shared/docs/intro.mdx index 8a2e69d95f..eccd87ee61 100644 --- a/packages/create-docusaurus/templates/shared/docs/intro.md +++ b/packages/create-docusaurus/templates/shared/docs/intro.mdx @@ -44,4 +44,4 @@ The `cd` command changes the directory you're working with. In order to work wit The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/. -Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes. +Open `docs/intro.mdx` (this page) and edit some lines: the site **reloads automatically** and displays your changes. diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.mdx similarity index 90% rename from packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.mdx index 04771a00b7..2917c3971f 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.mdx @@ -8,7 +8,7 @@ You have just learned the **basics of Docusaurus** and made some changes to the Docusaurus has **much more to offer**! -Have **5 more minutes**? Take a look at **[versioning](../tutorial-extras/manage-docs-versions.md)** and **[i18n](../tutorial-extras/translate-your-site.md)**. +Have **5 more minutes**? Take a look at **[versioning](../tutorial-extras/manage-docs-versions.mdx)** and **[i18n](../tutorial-extras/translate-your-site.mdx)**. Anything **unclear** or **buggy** in this tutorial? [Please report it!](https://github.com/facebook/docusaurus/discussions/4610) diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.mdx similarity index 94% rename from packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.mdx index ea472bbaf8..64996cc826 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-blog-post.mdx @@ -8,7 +8,7 @@ Docusaurus creates a **page for each blog post**, but also a **blog index page** ## Create your first Post -Create a file at `blog/2021-02-28-greetings.md`: +Create a file at `blog/2021-02-28-greetings.mdx`: ```md title="blog/2021-02-28-greetings.md" --- diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.mdx similarity index 100% rename from packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.mdx diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.mdx similarity index 85% rename from packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.mdx index 20e2ac3005..47bede297e 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-page.mdx @@ -7,7 +7,7 @@ sidebar_position: 1 Add **Markdown or React** files to `src/pages` to create a **standalone page**: - `src/pages/index.js` → `localhost:3000/` -- `src/pages/foo.md` → `localhost:3000/foo` +- `src/pages/foo.mdx` → `localhost:3000/foo` - `src/pages/foo/bar.js` → `localhost:3000/foo/bar` ## Create your first React Page @@ -32,9 +32,9 @@ A new page is now available at [http://localhost:3000/my-react-page](http://loca ## Create your first Markdown Page -Create a file at `src/pages/my-markdown-page.md`: +Create a file at `src/pages/my-markdown-page.mdx`: -```mdx title="src/pages/my-markdown-page.md" +```mdx title="src/pages/my-markdown-page.mdx" # My Markdown page This is a Markdown page diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/deploy-your-site.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/deploy-your-site.mdx similarity index 100% rename from packages/create-docusaurus/templates/shared/docs/tutorial-basics/deploy-your-site.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-basics/deploy-your-site.mdx diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/markdown-features.mdx b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/markdown-features.mdx index 0337f34d6a..9d988fdfc1 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/markdown-features.mdx +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/markdown-features.mdx @@ -10,7 +10,7 @@ Docusaurus supports **[Markdown](https://daringfireball.net/projects/markdown/sy Markdown documents have metadata at the top called [Front Matter](https://jekyllrb.com/docs/front-matter/): -```text title="my-doc.md" +```text title="my-doc.mdx" // highlight-start --- id: my-doc-id @@ -22,7 +22,7 @@ slug: /my-custom-url ## Markdown heading -Markdown text with [links](./hello.md) +Markdown text with [links](./hello.mdx) ``` ## Links @@ -34,10 +34,10 @@ Let's see how to [Create a page](/create-a-page). ``` ```md -Let's see how to [Create a page](./create-a-page.md). +Let's see how to [Create a page](./create-a-page.mdx). ``` -**Result:** Let's see how to [Create a page](./create-a-page.md). +**Result:** Let's see how to [Create a page](./create-a-page.mdx). ## Images diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.md b/packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.mdx similarity index 87% rename from packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.mdx index e12c3f3444..3bb7095438 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-extras/manage-docs-versions.mdx @@ -51,5 +51,5 @@ The docs version dropdown appears in your navbar: It is possible to edit versioned docs in their respective folder: -- `versioned_docs/version-1.0/hello.md` updates `http://localhost:3000/docs/hello` -- `docs/hello.md` updates `http://localhost:3000/docs/next/hello` +- `versioned_docs/version-1.0/hello.mdx` updates `http://localhost:3000/docs/hello` +- `docs/hello.mdx` updates `http://localhost:3000/docs/next/hello` diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.md b/packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.mdx similarity index 88% rename from packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.md rename to packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.mdx index 4294a27a5c..3ff57882ad 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.mdx @@ -4,7 +4,7 @@ sidebar_position: 2 # Translate your site -Let's translate `docs/intro.md` to French. +Let's translate `docs/intro.mdx` to French. ## Configure i18n @@ -21,15 +21,15 @@ module.exports = { ## Translate a doc -Copy the `docs/intro.md` file to the `i18n/fr` folder: +Copy the `docs/intro.mdx` file to the `i18n/fr` folder: ```bash mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ -cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md +cp docs/intro.mdx i18n/fr/docusaurus-plugin-content-docs/current/intro.mdx ``` -Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. +Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.mdx` in French. ## Start your localized site diff --git a/packages/create-docusaurus/templates/shared/src/pages/markdown-page.md b/packages/create-docusaurus/templates/shared/src/pages/markdown-page.mdx similarity index 100% rename from packages/create-docusaurus/templates/shared/src/pages/markdown-page.md rename to packages/create-docusaurus/templates/shared/src/pages/markdown-page.mdx