Beta docs

website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx → website/versioned_docs/version-3.0.0-beta.0/advanced/client.mdx

@@ -137,8 +137,6 @@ For every route transition, there will be several important timings:
 Note that the new page's DOM is only available during event (4). If you need to manipulate the new page's DOM, you'll likely want to use `onRouteDidUpdate`, which will be fired as soon as the DOM on the new page has mounted.
 
 ```js title="myClientModule.js"
-import type {Location} from 'history';
-
 export function onRouteDidUpdate({location, previousLocation}) {
   // Don't execute if we are still on the same page; the lifecycle may be fired
   // because the hash changes (e.g. when navigating between headings)

website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx → website/versioned_docs/version-3.0.0-beta.0/api/docusaurus.config.js.mdx

@@ -6,6 +6,8 @@ slug: /api/docusaurus-config
 
 # `docusaurus.config.js`
 
+import APITable from '@site/src/components/APITable';
+
 :::info
 
 Refer to the Getting Started [**Configuration**](../configuration.mdx) for examples.
@@ -400,8 +402,24 @@ The global Docusaurus Markdown config.
 - Type: `MarkdownConfig`
 
 ```ts
+type MarkdownPreprocessor = (args: {
+  filePath: string;
+  fileContent: string;
+}) => string;
+
+type MDX1CompatOptions =
+  | boolean
+  | {
+      comments: boolean;
+      admonitions: boolean;
+      headingIds: boolean;
+    };
+
 type MarkdownConfig = {
+  format: 'mdx' | 'md' | 'detect';
   mermaid: boolean;
+  preprocessor?: MarkdownPreprocessor;
+  mdx1Compat: MDX1CompatOptions;
 };
 ```
 
@@ -410,12 +428,34 @@ Example:
 ```js title="docusaurus.config.js"
 module.exports = {
   markdown: {
+    format: 'mdx',
     mermaid: true,
+    preprocessor: ({filePath, fileContent}) => {
+      return fileContent.replaceAll('{{MY_VAR}}', 'MY_VALUE');
+    },
+    mdx1Compat: {
+      comments: true,
+      admonitions: true,
+      headingIds: true,
+    },
   },
 };
 ```
 
-- `mermaid`: when `true`, allows Docusaurus to render Markdown code blocks with `mermaid` language as Mermaid diagrams.
+```mdx-code-block
+<APITable>
+```
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `format` | `'mdx' \| 'md' \| 'detect'` | `'mdx'` | The default parser format to use for Markdown content. Using 'detect' will select the appropriate format automatically based on file extensions: `.md` vs `.mdx`. |
+| `mermaid` | `boolean` | `false` | When `true`, allows Docusaurus to render Markdown code blocks with `mermaid` language as Mermaid diagrams. |
+| `preprocessor` | `MarkdownPreprocessor` | `undefined` | Gives you the ability to alter the Markdown content string before parsing. Use it as a last-resort escape hatch or workaround: it is almost always better to implement a Remark/Rehype plugin. |
+| `mdx1Compat` | `MDX1CompatOptions` | `{comments: true, admonitions: true, headingIds: true}` | Compatibility options to make it easier to upgrade to Docusaurus v3+. See the [MDX 2 PR for details](https://github.com/facebook/docusaurus/pull/8288). |
+
+```mdx-code-block
+</APITable>
+```
 
 ### `customFields` {#customFields}
 

website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx → website/versioned_docs/version-3.0.0-beta.0/api/misc/create-docusaurus.mdx

@@ -47,10 +47,10 @@ Used when the template argument is a git repo. It needs to be one of:
 
 ### `-p, --package-manager` {#package-manager}
 
-Value should be one of `npm`, `yarn`, or `pnpm`. If it's not explicitly provided, Docusaurus will infer one based on:
+Value should be one of `npm`, `yarn`, `pnpm`, or `bun`. If it's not explicitly provided, Docusaurus will infer one based on:
 
 - The lockfile already present in the CWD (e.g. if you are setting up website in an existing project)
-- The command used to invoke `create-docusaurus` (e.g. `npm init`, `npx`, `yarn create`, etc.)
+- The command used to invoke `create-docusaurus` (e.g. `npm init`, `npx`, `yarn create`, `bunx`, etc.)
 - Interactive prompting, in case all heuristics are not present
 
 ### `-s, --skip-install` {#skip-install}

website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx → website/versioned_docs/version-3.0.0-beta.0/api/misc/logger/logger.mdx

@@ -49,6 +49,8 @@ In addition, `warn` and `error` will color the **entire** message for better att
 The template literal tag evaluates the template and expressions embedded. `interpolate` returns a new string, while other logging functions prints it. Below is a typical usage:
 
 ```js
+import logger from '@docusaurus/logger';
+
 logger.info`Hello name=${name}! You have number=${money} dollars. Here are the ${
   items.length > 1 ? 'items' : 'item'
 } on the shelf: ${items}

website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx → website/versioned_docs/version-3.0.0-beta.0/api/plugins/plugin-content-blog.mdx

@@ -68,6 +68,7 @@ Accepted fields:
 | `feedOptions` | _See below_ | `{type: ['rss', 'atom']}` | Blog feed. |
 | `feedOptions.type` | <code><a href="#FeedType">FeedType</a> \| <a href="#FeedType">FeedType</a>[] \| 'all' \| null</code> | **Required** | Type of feed to be generated. Use `null` to disable generation. |
 | `feedOptions.createFeedItems` | <code><a href="#CreateFeedItemsFn">CreateFeedItemsFn</a> \| undefined</code> | `undefined` | An optional function which can be used to transform and / or filter the items in the feed. |
+| `feedOptions.limit` | `number \| null \| false` | `20` | Limits the feed to the specified number of posts, `false` or `null` for all entries. Defaults to `20`. |
 | `feedOptions.title` | `string` | `siteConfig.title` | Title of the feed. |
 | `feedOptions.description` | `string` | <code>\`$\{siteConfig.title} Blog\`</code> | Description of the feed. |
 | `feedOptions.copyright` | `string` | `undefined` | Copyright message. |

website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx → website/versioned_docs/version-3.0.0-beta.0/api/themes/theme-configuration.mdx

@@ -767,7 +767,7 @@ Accepted fields:
 | --- | --- | --- | --- |
 | `theme` | `PrismTheme` | `palenight` | The Prism theme to use for light-theme code blocks. |
 | `darkTheme` | `PrismTheme` | `palenight` | The Prism theme to use for dark-theme code blocks. |
-| `defaultLanguage` | `string` | `undefined` | The side of the navbar this item should appear on. |
+| `defaultLanguage` | `string` | `undefined` | The default language to use for code blocks not declaring any explicit language. |
 | `magicComments` | `MagicCommentConfig[]` | _see below_ | The list of [magic comments](../../guides/markdown-features/markdown-features-code-blocks.mdx#custom-magic-comments). |
 
 ```mdx-code-block

website/versioned_docs/version-3.0.0-alpha.0/blog.mdx → website/versioned_docs/version-3.0.0-beta.0/blog.mdx

@@ -520,6 +520,7 @@ type BlogOptions = {
     description?: string;
     copyright: string;
     language?: string; // possible values: http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes
+    limit?: number | false | null; // defaults to 20
     /** Allow control over the construction of BlogFeedItems */
     createFeedItems?: (params: {
       blogPosts: BlogPost[];