From 0fc479717c6726b974d0617c5e5ed11bd70b5700 Mon Sep 17 00:00:00 2001 From: Kesyau <5733426+Kesyau@users.noreply.github.com> Date: Thu, 5 Jan 2023 14:27:00 +0800 Subject: [PATCH 1/2] docs(website): fix broken links to browserslist --- website/docs/browser-support.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/browser-support.mdx b/website/docs/browser-support.mdx index 2e61e9dbb4fe..404601d8f45e 100644 --- a/website/docs/browser-support.mdx +++ b/website/docs/browser-support.mdx @@ -103,4 +103,4 @@ safari 13.1 ## Read more {#read-more} -You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.mdx) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.mdx#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.mdx#best-practices). +You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.md) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.md#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.md#best-practices). From 0df37743241f9f79b484e211e20c2c8deb31984d Mon Sep 17 00:00:00 2001 From: sebastienlorber Date: Thu, 5 Jan 2023 13:06:45 +0100 Subject: [PATCH 2/2] revert some bad .mdx md link changes --- website/blog/2017-12-14-introducing-docusaurus.mdx | 2 +- website/docs/cli.mdx | 2 +- .../guides/markdown-features/markdown-features-plugins.mdx | 4 ++-- website/docs/migration/migration-manual.mdx | 2 +- website/versioned_docs/version-2.0.1/browser-support.mdx | 2 +- website/versioned_docs/version-2.0.1/cli.mdx | 2 +- .../guides/markdown-features/markdown-features-plugins.mdx | 4 ++-- .../version-2.0.1/migration/migration-manual.mdx | 2 +- website/versioned_docs/version-2.1.0/browser-support.mdx | 2 +- website/versioned_docs/version-2.1.0/cli.mdx | 2 +- .../guides/markdown-features/markdown-features-plugins.mdx | 4 ++-- .../version-2.1.0/migration/migration-manual.mdx | 2 +- website/versioned_docs/version-2.2.0/browser-support.mdx | 2 +- website/versioned_docs/version-2.2.0/cli.mdx | 2 +- .../guides/markdown-features/markdown-features-plugins.mdx | 4 ++-- .../version-2.2.0/migration/migration-manual.mdx | 2 +- 16 files changed, 20 insertions(+), 20 deletions(-) diff --git a/website/blog/2017-12-14-introducing-docusaurus.mdx b/website/blog/2017-12-14-introducing-docusaurus.mdx index 8f9a42310a40..84ed69c4027e 100644 --- a/website/blog/2017-12-14-introducing-docusaurus.mdx +++ b/website/blog/2017-12-14-introducing-docusaurus.mdx @@ -129,7 +129,7 @@ build ![](/img/docusaurus.svg) -We welcome your [contributions](https://github.com/facebook/docusaurus/blob/master/CONTRIBUTING.mdx) to Docusaurus, whether you want to use it for your own site, you want to [contribute](https://github.com/facebook/docusaurus/blob/master/CONTRIBUTING.mdx) to the Docusaurus core or just have questions. Follow us on [GitHub](https://github.com/facebook/docusaurus) and [Twitter](https://twitter.com/docusaurus). +We welcome your [contributions](https://github.com/facebook/docusaurus/blob/master/CONTRIBUTING.md) to Docusaurus, whether you want to use it for your own site, you want to [contribute](https://github.com/facebook/docusaurus/blob/master/CONTRIBUTING.md) to the Docusaurus core or just have questions. Follow us on [GitHub](https://github.com/facebook/docusaurus) and [Twitter](https://twitter.com/docusaurus). ## Acknowledgements diff --git a/website/docs/cli.mdx b/website/docs/cli.mdx index a317f5b6a1eb..02321c3889f9 100644 --- a/website/docs/cli.mdx +++ b/website/docs/cli.mdx @@ -92,7 +92,7 @@ Compiles your site for production. :::info -For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.mdx) if you experience CSS minification bugs.** +For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.md) if you experience CSS minification bugs.** You can skip the HTML minification with the environment variable `SKIP_HTML_MINIFICATION=true`. diff --git a/website/docs/guides/markdown-features/markdown-features-plugins.mdx b/website/docs/guides/markdown-features/markdown-features-plugins.mdx index b616687a84dc..1aa78617f306 100644 --- a/website/docs/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/docs/guides/markdown-features/markdown-features-plugins.mdx @@ -14,7 +14,7 @@ Sometimes, you may want to extend or tweak your Markdown syntax. For example: And the answer is: create an MDX plugin! MDX has a built-in [plugin system](https://mdxjs.com/advanced/plugins/) that can be used to customize how the Markdown files will be parsed and transformed to JSX. There are three typical use-cases of MDX plugins: -- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.mdx#list-of-plugins); +- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.md#list-of-plugins); - Creating remark/rehype plugins to transform the elements generated by existing MDX syntax; - Creating remark/rehype plugins to introduce new syntaxes to MDX. @@ -121,7 +121,7 @@ If there isn't an existing package that satisfies your customization need, you c :::note -The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#create-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#create-plugins) documentation for a more in-depth explanation of how they work. +The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#create-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#create-plugins) documentation for a more in-depth explanation of how they work. ::: diff --git a/website/docs/migration/migration-manual.mdx b/website/docs/migration/migration-manual.mdx index 53a3dcf305b1..95a8c47d0465 100644 --- a/website/docs/migration/migration-manual.mdx +++ b/website/docs/migration/migration-manual.mdx @@ -123,7 +123,7 @@ yarn-error.log* ### `README` {#readme} -The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.mdx). +The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.md). ## Site configurations {#site-configurations} diff --git a/website/versioned_docs/version-2.0.1/browser-support.mdx b/website/versioned_docs/version-2.0.1/browser-support.mdx index 2e61e9dbb4fe..404601d8f45e 100644 --- a/website/versioned_docs/version-2.0.1/browser-support.mdx +++ b/website/versioned_docs/version-2.0.1/browser-support.mdx @@ -103,4 +103,4 @@ safari 13.1 ## Read more {#read-more} -You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.mdx) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.mdx#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.mdx#best-practices). +You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.md) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.md#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.md#best-practices). diff --git a/website/versioned_docs/version-2.0.1/cli.mdx b/website/versioned_docs/version-2.0.1/cli.mdx index 0dab727cf33a..2f57a03ba0d8 100644 --- a/website/versioned_docs/version-2.0.1/cli.mdx +++ b/website/versioned_docs/version-2.0.1/cli.mdx @@ -92,7 +92,7 @@ Compiles your site for production. :::info -For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.mdx) if you experience CSS minification bugs.** +For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.md) if you experience CSS minification bugs.** You can skip the HTML minification with the environment variable `SKIP_HTML_MINIFICATION=true`. diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-plugins.mdx index 5be584c5eb8f..50e6d37a6d4c 100644 --- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-plugins.mdx @@ -14,7 +14,7 @@ Sometimes, you may want to extend or tweak your Markdown syntax. For example: And the answer is: create an MDX plugin! MDX has a built-in [plugin system](https://mdxjs.com/advanced/plugins/) that can be used to customize how the Markdown files will be parsed and transformed to JSX. There are three typical use-cases of MDX plugins: -- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.mdx#list-of-plugins); +- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.md#list-of-plugins); - Creating remark/rehype plugins to transform the elements generated by existing MDX syntax; - Creating remark/rehype plugins to introduce new syntaxes to MDX. @@ -121,7 +121,7 @@ If there isn't an existing package that satisfies your customization need, you c :::note -The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) documentation for a more in-depth explanation of how they work. +The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) documentation for a more in-depth explanation of how they work. ::: diff --git a/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx b/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx index 53a3dcf305b1..95a8c47d0465 100644 --- a/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx +++ b/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx @@ -123,7 +123,7 @@ yarn-error.log* ### `README` {#readme} -The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.mdx). +The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.md). ## Site configurations {#site-configurations} diff --git a/website/versioned_docs/version-2.1.0/browser-support.mdx b/website/versioned_docs/version-2.1.0/browser-support.mdx index 2e61e9dbb4fe..404601d8f45e 100644 --- a/website/versioned_docs/version-2.1.0/browser-support.mdx +++ b/website/versioned_docs/version-2.1.0/browser-support.mdx @@ -103,4 +103,4 @@ safari 13.1 ## Read more {#read-more} -You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.mdx) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.mdx#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.mdx#best-practices). +You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.md) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.md#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.md#best-practices). diff --git a/website/versioned_docs/version-2.1.0/cli.mdx b/website/versioned_docs/version-2.1.0/cli.mdx index 0dab727cf33a..2f57a03ba0d8 100644 --- a/website/versioned_docs/version-2.1.0/cli.mdx +++ b/website/versioned_docs/version-2.1.0/cli.mdx @@ -92,7 +92,7 @@ Compiles your site for production. :::info -For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.mdx) if you experience CSS minification bugs.** +For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.md) if you experience CSS minification bugs.** You can skip the HTML minification with the environment variable `SKIP_HTML_MINIFICATION=true`. diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-plugins.mdx index 5be584c5eb8f..50e6d37a6d4c 100644 --- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-plugins.mdx @@ -14,7 +14,7 @@ Sometimes, you may want to extend or tweak your Markdown syntax. For example: And the answer is: create an MDX plugin! MDX has a built-in [plugin system](https://mdxjs.com/advanced/plugins/) that can be used to customize how the Markdown files will be parsed and transformed to JSX. There are three typical use-cases of MDX plugins: -- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.mdx#list-of-plugins); +- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.md#list-of-plugins); - Creating remark/rehype plugins to transform the elements generated by existing MDX syntax; - Creating remark/rehype plugins to introduce new syntaxes to MDX. @@ -121,7 +121,7 @@ If there isn't an existing package that satisfies your customization need, you c :::note -The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) documentation for a more in-depth explanation of how they work. +The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) documentation for a more in-depth explanation of how they work. ::: diff --git a/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx b/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx index 53a3dcf305b1..95a8c47d0465 100644 --- a/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx +++ b/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx @@ -123,7 +123,7 @@ yarn-error.log* ### `README` {#readme} -The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.mdx). +The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.md). ## Site configurations {#site-configurations} diff --git a/website/versioned_docs/version-2.2.0/browser-support.mdx b/website/versioned_docs/version-2.2.0/browser-support.mdx index 2e61e9dbb4fe..404601d8f45e 100644 --- a/website/versioned_docs/version-2.2.0/browser-support.mdx +++ b/website/versioned_docs/version-2.2.0/browser-support.mdx @@ -103,4 +103,4 @@ safari 13.1 ## Read more {#read-more} -You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.mdx) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.mdx#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.mdx#best-practices). +You may wish to visit the [browserslist documentation](https://github.com/browserslist/browserslist/blob/main/README.md) for more specifications, especially the accepted [query values](https://github.com/browserslist/browserslist/blob/main/README.md#queries) and [best practices](https://github.com/browserslist/browserslist/blob/main/README.md#best-practices). diff --git a/website/versioned_docs/version-2.2.0/cli.mdx b/website/versioned_docs/version-2.2.0/cli.mdx index a317f5b6a1eb..02321c3889f9 100644 --- a/website/versioned_docs/version-2.2.0/cli.mdx +++ b/website/versioned_docs/version-2.2.0/cli.mdx @@ -92,7 +92,7 @@ Compiles your site for production. :::info -For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.mdx) if you experience CSS minification bugs.** +For advanced minification of CSS bundle, we use the [advanced cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-advanced) (along with additional several PostCSS plugins) and [level 2 optimization of clean-css](https://github.com/jakubpawlowicz/clean-css#level-2-optimizations). If as a result of this advanced CSS minification you find broken CSS, build your website with the environment variable `USE_SIMPLE_CSS_MINIFIER=true` to minify CSS with the [default cssnano preset](https://github.com/cssnano/cssnano/tree/master/packages/cssnano-preset-default). **Please [fill out an issue](https://github.com/facebook/docusaurus/issues/new?labels=bug%2C+needs+triage&template=bug.md) if you experience CSS minification bugs.** You can skip the HTML minification with the environment variable `SKIP_HTML_MINIFICATION=true`. diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-plugins.mdx index 5be584c5eb8f..50e6d37a6d4c 100644 --- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-plugins.mdx @@ -14,7 +14,7 @@ Sometimes, you may want to extend or tweak your Markdown syntax. For example: And the answer is: create an MDX plugin! MDX has a built-in [plugin system](https://mdxjs.com/advanced/plugins/) that can be used to customize how the Markdown files will be parsed and transformed to JSX. There are three typical use-cases of MDX plugins: -- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.mdx#list-of-plugins); +- Using existing [remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#list-of-plugins) or [rehype plugins](https://github.com/rehypejs/rehype/blob/main/doc/plugins.md#list-of-plugins); - Creating remark/rehype plugins to transform the elements generated by existing MDX syntax; - Creating remark/rehype plugins to introduce new syntaxes to MDX. @@ -121,7 +121,7 @@ If there isn't an existing package that satisfies your customization need, you c :::note -The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.mdx#creating-plugins) documentation for a more in-depth explanation of how they work. +The writeup below is **not** meant to be a comprehensive guide to creating a plugin, but just an illustration of how to make it work with Docusaurus. Visit the [Remark](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) or [Rehype](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#creating-plugins) documentation for a more in-depth explanation of how they work. ::: diff --git a/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx b/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx index 53a3dcf305b1..95a8c47d0465 100644 --- a/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx +++ b/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx @@ -123,7 +123,7 @@ yarn-error.log* ### `README` {#readme} -The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.mdx). +The D1 website may have an existing README file. You can modify it to reflect the D2 changes, or copy the default [Docusaurus v2 README](https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/README.md). ## Site configurations {#site-configurations}