# nextra

## 4.6.5

### Patch Changes

- 36ba79c: Fix `GIT_ROOT` resolution for git worktrees so MDX
  `getFileLatestModifiedDateAsync` lookups don't hang `next build`.

  `repository.path()` returns `<repo>/.git/worktrees/<name>/` inside a worktree,
  so `path.join(repository.path(), '..')` resolved to `<repo>/.git/worktrees/` —
  the wrong directory. Every per-file timestamp lookup then walked the full
  history from a path that didn't exist relative to the calculated root, taking
  ~1.6 s per file (a 110-file site went from ~1.8 s total to ~176 s).

  `repository.workdir()` returns the correct working directory for both regular
  checkouts and worktrees, with a fallback to the old behaviour for bare
  repositories where `workdir()` is undefined.

## 4.6.4

## 4.6.3

## 4.6.2

### Patch Changes

- 9e6f5af: Fix Pagefind search not working when using `basePath` in Next.js
  config

  When deploying Nextra to a subpath (e.g., `basePath: '/docs'`), the Pagefind
  search would fail to load index files because `baseUrl` was hardcoded to `'/'`
  instead of using `addBasePath('/')`.

## 4.6.1

### Patch Changes

- 261fcdc: - update zod to v4 stable
  - fix compatibility with Next.js 16

## 4.6.0

## 4.5.1

### Patch Changes

- 8a4d176: fix TSDoc `@inline` tag to properly expand nested type aliases

## 4.5.0

### Minor Changes

- 356a782: fix copy page button does not return the correct page contents due to
  cached MDX compiler

  add a `copyPageButton` layout prop which show/hide copy page content button

## 4.4.0

### Minor Changes

- 26b1281: feat: add Copy Documentation button/dropdown feature as LLM-Optimized
  Prompt

  ![](https://private-user-images.githubusercontent.com/7361780/473206831-aa851d94-3b83-46e8-8b00-5bf06c33314f.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTQ0NjgwNzUsIm5iZiI6MTc1NDQ2Nzc3NSwicGF0aCI6Ii83MzYxNzgwLzQ3MzIwNjgzMS1hYTg1MWQ5NC0zYjgzLTQ2ZTgtOGIwMC01YmYwNmMzMzMxNGYucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDgwNiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA4MDZUMDgwOTM1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MjgwZTI3YWMzODYwNjEwNTgwNGUyOTJkMDg5MzNjOGRjZWE0MWYzMWQwZmM3ZDJkMjQzMDc2ZDRjMzQ4ZTRlZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.C7LZXaay7uuPQsDBb3MKLrbiBWxTPM2q9nfSqUGp3_0)

  > **Note**
  >
  > If you are using
  > [`content` directory](https://nextra.site/docs/file-conventions/content-directory),
  > you **must** pass the `sourceCode` prop to enable this feature.
  >
  > ```diff
  > const {
  >   default: MDXContent,
  >   toc,
  >   metadata,
  > + sourceCode
  > } = await importPage(params.mdxPath)
  > return (
  > - <Wrapper toc={toc} metadata={metadata}>
  > + <Wrapper toc={toc} metadata={metadata} sourceCode={sourceCode}>
  >     <MDXContent {...props} params={params} />
  >   </Wrapper>
  > )
  > ```

## 4.3.0

### Minor Changes

- eed8328: feat: adapt colors and icons from original GitHub alerts syntax

  feat: new Callout type `important`

  fix: inconsistent built-in Callout's icons size

  feat: improve Callout's accessibility colors

- 0831a1b: Add an `onSearch` callback to the `<Search />` component. This
  callback, when specified, is called upon every search input change.
- b0afee7: feat(tsdoc): add support for `@inline` tag on function parameters
- c93fc48: update zod to v4

  feat(TSDoc): rename `generateDocumentation` to `generateDefinition`

  feat(Bleed): pass all props from `div` element to `Bleed`, `Callout`, `Banner`
  container

  fix(TSDoc): improve TSDoc comments for components
  - `Banner`
  - `Head`
  - `Search`
  - `Bleed`
  - `Callout`
  - `Cards`
  - `FileTree`
  - `Steps`
  - `Table`
  - `Tabs`
  - `Playground`
  - `TSDoc`
  - `Layout`
  - `Navbar`

  fix(TSDoc): improve TSDoc comments for functions:
  - `nextra`
  - `generateDefinition`
  - `useMDXComponents`

- 01ac538: feat(tsdoc): support @inline tag and fix mobile overflow in <TSDoc />
  table
- 94b081c: feat: refactor `<Search>` component styles for improved transitions
  and visibility
- b5fab80: add `MDXRemote` component docs page
  https://nextra.site/docs/built-ins/mdxremote
- ef35ab9: accept all `ComboboxInputProps` in Nextra's `<Search />` component
- d9dd061: update `tailwindcss` to `4.1.10` and `react-compiler-runtime` to
  `19.1.0-rc.2`
- c134abe: feat: improve overall accessibility, makes text/colors easier to read
  and achieves WCAG Level AAA compliance in many places
- 83f6c57: feat: introduce new `<TSDoc />` component

  The `<TSDoc>` component from `nextra/tsdoc` generates a properties table that
  displays:
  - **Property name**
  - **TypeScript type**
  - **Property description** - is parsed from [TSDoc](https://tsdoc.org) inline
    description or the `@description` tag. You can use any Markdown/MDX syntax
    here.
  - **Default value** - are extracted from the `@default` or `@defaultValue`
    tag.
  - **Permalink** - a `#` anchor link to the property row for easy reference.

  More info can be found in https://nextra.site/docs/built-ins/tsdoc

  > [!IMPORTANT]
  >
  > Huge thanks to
  > [xyflow - Node Based UIs for React and Svelte](https://xyflow.com/?utm_source=github&utm_campaign=nextra-4.3&utm_content=changelog)
  > for sponsoring this feature!

- 07debf9: feat(TSDoc): support flattening return object fields

### Patch Changes

- 71f7b3f: Update https://nextra.site/docs/guide/search page

  Fixes extra margin-top inside `Tabs.Tab`

  Fix breaking `<Steps>` component numeration when there is `<Tabs>` component
  inside

- 47ba5f3: fix: use `em` for padding-y, padding-x and border-radius styles of
  `<Code>` element

  fix(TSDoc): for return signature without `name` return mobile card instead of
  table

  feat: use `em` instead `rem` for margins

- 40267dc: split `TSDoc` component logic to `TSDoc` component and
  `generateDocumentation` function

  update https://nextra.site/docs/built-ins/tsdoc documentation

- f717156: feat(TSDoc): enable `exactOptionalPropertyTypes` and
  `strictNullChecks` in ts-morph `compilerOptions`
- 9f449e5: fix(TSDoc): should show `null` type in properties table
- 8ac2506: chore: bump `babel-plugin-react-compiler` and
  `react-compiler-runtime`, remove custom pnpm patch for
  `babel-plugin-react-compiler`
- a6a1f97: fix(tsdoc): check `@inline` and `@remarks` tags on alias type too in
  addition to field tags
- fda0355: fix tsdoc File not found: /var/task/.../tsconfig.json
- b2cba90: improve TSDoc comments for `getPageMap`, `generateStaticParamsFor`
  and `importPage` functions. Add new https://nextra.site/docs/guide/api page.
- f40e018: fix TSDoc error `Expected to find an alias symbol` when using
  `@inline` comment
- d29469e: support Next.js 15.3.0
- 6a82e6f: - Fix: Received `false` for a non-boolean attribute `prefetch`.
  - Allow override `next-mdx-import-source-file` in `turbopack.resolveAlias`
    option
- 7de40fb: Update Tailwind CSS guide to match v4 version
  https://nextra.site/docs/advanced/tailwind-css
- c7d25df: fix(tsdoc): should resolve `Partial` types as declared
- 4547eb9: feat(TSDoc): add support for functions and functions with multiple
  signatures
- 407e0c4: feat(TSDoc): add `TSDoc.noParametersContent` prop
- 00f4696: add https://nextra.site/api page generated with TSDoc component
- 31ddba4: improve LaTeX docs, mention that you need apply styles for KaTeX
  https://nextra.site/docs/advanced/latex#apply-styles
- a506e0b: fix `TypeError: page.generateMetadata is not a function` when using
  with `withSentryConfig` plugin
- 9690841: Upgrade remark-reading-time to 2.0.2 in dependencies.

## 4.3.0-alpha.31

### Patch Changes

- f40e018: fix TSDoc error `Expected to find an alias symbol` when using
  `@inline` comment

## 4.3.0-alpha.30

### Minor Changes

- b0afee7: feat(tsdoc): add support for `@inline` tag on function parameters

## 4.3.0-alpha.29

### Patch Changes

- a6a1f97: fix(tsdoc): check `@inline` and `@remarks` tags on alias type too in
  addition to field tags

## 4.3.0-alpha.28

### Minor Changes

- ef35ab9: accept all `ComboboxInputProps` in Nextra's `<Search />` component

## 4.3.0-alpha.27

### Minor Changes

- 01ac538: feat(tsdoc): support @inline tag and fix mobile overflow in <TSDoc />
  table

## 4.3.0-alpha.26

### Patch Changes

- c7d25df: fix(tsdoc): should resolve `Partial` types as declared

## 4.3.0-alpha.25

### Minor Changes

- d9dd061: update `tailwindcss` to `4.1.10` and `react-compiler-runtime` to
  `19.1.0-rc.2`

## 4.3.0-alpha.24

### Minor Changes

- 0831a1b: Add an `onSearch` callback to the `<Search />` component. This
  callback, when specified, is called upon every search input change.

## 4.3.0-alpha.23

### Patch Changes

- 9690841: Upgrade remark-reading-time to 2.0.2 in dependencies.

## 4.3.0-alpha.22

### Minor Changes

- c93fc48: update zod to v4

  feat(TSDoc): rename `generateDocumentation` to `generateDefinition`

  feat(Bleed): pass all props from `div` element to `Bleed`, `Callout`, `Banner`
  container

  fix(TSDoc): improve TSDoc comments for components
  - `Banner`
  - `Head`
  - `Search`
  - `Bleed`
  - `Callout`
  - `Cards`
  - `FileTree`
  - `Steps`
  - `Table`
  - `Tabs`
  - `Playground`
  - `TSDoc`
  - `Layout`
  - `Navbar`

  fix(TSDoc): improve TSDoc comments for functions:
  - `nextra`
  - `generateDefinition`
  - `useMDXComponents`

- b5fab80: add `MDXRemote` component docs page
  https://nextra.site/docs/built-ins/mdxremote

## 4.3.0-alpha.21

### Patch Changes

- 6a82e6f: - Fix: Received `false` for a non-boolean attribute `prefetch`.
  - Allow override `next-mdx-import-source-file` in `turbopack.resolveAlias`
    option

## 4.3.0-alpha.20

## 4.3.0-alpha.19

### Patch Changes

- 407e0c4: feat(TSDoc): add `TSDoc.noParametersContent` prop

## 4.3.0-alpha.18

### Patch Changes

- 7de40fb: Update Tailwind CSS guide to match v4 version
  https://nextra.site/docs/advanced/tailwind-css
- 00f4696: add https://nextra.site/api page generated with TSDoc component
- 31ddba4: improve LaTeX docs, mention that you need apply styles for KaTeX
  https://nextra.site/docs/advanced/latex#apply-styles

## 4.3.0-alpha.17

## 4.3.0-alpha.16

## 4.3.0-alpha.15

### Patch Changes

- b2cba90: improve TSDoc comments for `getPageMap`, `generateStaticParamsFor`
  and `importPage` functions. Add new https://nextra.site/docs/guide/api page.

## 4.3.0-alpha.14

### Patch Changes

- a506e0b: fix `TypeError: page.generateMetadata is not a function` when using
  with `withSentryConfig` plugin

## 4.3.0-alpha.13

### Patch Changes

- 47ba5f3: fix: use `em` for padding-y, padding-x and border-radius styles of
  `<Code>` element

  fix(TSDoc): for return signature without `name` return mobile card instead of
  table

  feat: use `em` instead `rem` for margins

- d29469e: support Next.js 15.3.0

## 4.3.0-alpha.12

### Patch Changes

- 40267dc: split `TSDoc` component logic to `TSDoc` component and
  `generateDocumentation` function

  update https://nextra.site/docs/built-ins/tsdoc documentation

## 4.3.0-alpha.11

### Patch Changes

- 71f7b3f: Update https://nextra.site/docs/guide/search page

  Fixes extra margin-top inside `Tabs.Tab`

  Fix breaking `<Steps>` component numeration when there is `<Tabs>` component
  inside

## 4.3.0-alpha.10

## 4.3.0-alpha.9

### Minor Changes

- 94b081c: feat: refactor `<Search>` component styles for improved transitions
  and visibility

## 4.3.0-alpha.8

### Minor Changes

- c134abe: feat: improve overall accessibility, makes text/colors easier to read
  and achieves WCAG Level AAA compliance in many places

## 4.3.0-alpha.7

### Minor Changes

- 07debf9: feat(TSDoc): support flattening return object fields

## 4.3.0-alpha.6

## 4.3.0-alpha.5

### Minor Changes

- eed8328: feat: adapt colors and icons from original GitHub alerts syntax

  feat: new Callout type `important`

  fix: inconsistent built-in Callout's icons size

  feat: improve Callout's accessibility colors

## 4.3.0-alpha.4

### Patch Changes

- 4547eb9: feat(TSDoc): add support for functions and functions with multiple
  signatures

## 4.3.0-alpha.3

### Patch Changes

- f717156: feat(TSDoc): enable `exactOptionalPropertyTypes` and
  `strictNullChecks` in ts-morph `compilerOptions`

## 4.3.0-alpha.2

### Patch Changes

- 8ac2506: chore: bump `babel-plugin-react-compiler` and
  `react-compiler-runtime`, remove custom pnpm patch for
  `babel-plugin-react-compiler`

## 4.3.0-alpha.1

### Patch Changes

- 9f449e5: fix(TSDoc): should show `null` type in properties table

## 4.3.0-alpha.0

### Minor Changes

- 83f6c57: feat: introduce new `<TSDoc />` component

  The `<TSDoc>` component from `nextra/tsdoc` generates a properties table that
  displays:
  - **Property name**
  - **TypeScript type**
  - **Property description** - is parsed from [TSDoc](https://tsdoc.org) inline
    description or the `@description` tag. You can use any Markdown/MDX syntax
    here.
  - **Default value** - are extracted from the `@default` or `@defaultValue`
    tag.
  - **Permalink** - a `#` anchor link to the property row for easy reference.

  More info can be found in https://nextra.site/docs/built-ins/tsdoc

  > [!IMPORTANT]
  >
  > Huge thanks to
  > [xyflow - Node Based UIs for React and Svelte](https://xyflow.com/?utm_source=github&utm_campaign=nextra-4.3&utm_content=changelog)
  > for sponsoring this feature!

## 4.2.18

### Patch Changes

- e1c2b1b: chore: update `shiki` and `@shikijs/twoslash` packages to version 3

## 4.2.17

### Patch Changes

- a7db0e6: fix: use correct `ReactNode` zod validation for
  `Layout.footer/banner/editLink/feedback.content/toc.backToTop/toc.extraContent/toc.title/search`
  and `Navbar.children/projectIcon/chatIcon`
- 18e7fb9: fix: allow override `NextraConfig.mdxOptions.format` option in
  `next.config` file

## 4.2.16

### Patch Changes

- 2cfaacc: fix: frozen spinner on loading state in search results by updating
  Tailwind CSS to v4.0.10

## 4.2.15

### Patch Changes

- 5617e04: fix: loading state in search results was only visible during the
  first search

## 4.2.14

### Patch Changes

- ccb5da2: removing custom nextra's scrollbar styles, allowing the browser's
  default scrollbars to be used
- 05a202d: fix: make search results appear above the navbar

## 4.2.13

### Patch Changes

- fc4035c: add code block icon for `svelte` language
- fc4035c: increase `z-index` for banner to `30` to fix hidden banner when
  mobile nav is open

## 4.2.12

## 4.2.11

## 4.2.10

### Patch Changes

- 5c22495: - add `Navbar.align` prop to align navigation links to the specified
  side. (default `'right'`)
  - fix hidden nav links when specified with `type: 'page', href: '...'` in
    `_meta` files

## 4.2.9

## 4.2.8

## 4.2.7

## 4.2.6

### Patch Changes

- a7906d1: use `decodeURIComponent` instead `decodeURI` to properly decode `&`
  character

## 4.2.5

### Patch Changes

- e6c3050: add `display: 'normal' | 'hidden'` for `_meta` item `type: 'menu'`

## 4.2.4

### Patch Changes

- b46d831: fix `Could not parse expression with acorn` for inline math code in
  `development` mode without turbopack enabled
- 7949e28: move setting `pageMap` items' `title` property from `normalizePages`
  to `sortFolder`

## 4.2.3

### Patch Changes

- ca67a19: remove requirement `page.{jsx,tsx}` pages to have exported `metadata`
  object

## 4.2.2

### Patch Changes

- dd32eca: fix route group within `app/` dir crash the `convertToPageMap`

## 4.2.1

## 4.2.0

### Patch Changes

- 427b080: calculate `--nextra-banner-height` after mounting banner, so banner
  text can be wrapped on multiple lines
- 6b8053f: fix a sudden height jump on opening for `<detail>` element when his
  last children contain margins
- b0e686e: hide default `<summary>` arrow on mobile

## 4.1.1

### Patch Changes

- 29a44de: fix regression from Nextra 3 setting
  [`theme.collapsed?: boolean` in `_meta` file](https://nextra.site/docs/file-conventions/meta-file#theme-option)
  for folders has no effect in sidebar
- 19578c3: improve github alert syntax name in DOM

## 4.1.0

### Minor Changes

- 7caf059: - generate unique anchor id for `<summary>` elements based on its
  content at build time
  - add anchor link icon for `<summary>`

## 4.0.9

### Patch Changes

- e78f796: fix console error from `<Search>` results error
  `TypeError: Cannot destructure property 'results' of '(intermediate value)' as it is null.`

  select right tab and scroll into view when html element with `location.hash`
  id is inside `<Tabs.Tab>`

- ff007b2: fix clicking on search result from same page doesn't scroll to the
  heading

## 4.0.8

### Patch Changes

- 267ef81: fix parsing empty front matter

## 4.0.7

### Patch Changes

- 32e7d55: fix `::selection` styles, use `hsla` instead of `hsl` because it can
  overlap text with `::selection` background when `background-clip: text` is set
- 695e428: add new nextra config option `unstable_shouldAddLocaleToLinks` to
  append locale to all links, for i18n websites which uses static exports and
  can't use Nextra middleware
- fc78033: fix crash of Nextra when `props` are used within headings, e.g.
  `## Hello {props.something}`
- b2f2458: do not log a bunch of
  `Failed to get the last modified timestamp from Git for the file` messages if
  init git repository failed

## 4.0.6

### Patch Changes

- 44ea060: correctly handle non-English characters in filenames for `.md` and
  `.mdx` pages

## 4.0.5

### Patch Changes

- 14bf091: fix build crash after renaming mdx pages

## 4.0.4

### Patch Changes

- 5132295: fix broken `showLineNumbers` setting on code blocks
- 5132295: fix unable order \_meta key with `index` name

## 4.0.3

## 4.0.2

## 4.0.1

### Patch Changes

- 481e0d0: fix syntax highlighting for `mdx` lang and improve docs for
  `/docs/docs-theme/start`
- 426cd66: Remove margin-top from `.nextra-steps` `:before` pseudo selector

## 4.0.0

### Major Changes

- 283320f: remove `"typesVersions"` field from `package.json`. You need to set
  `"moduleResolution": "bundler"` in your `tsconfig.json` if you are using
  TypeScript
- 283320f: move `<Collapse>`, `<Details>`, `<Summary>`, `<SkipNavContent>`,
  `SkipNavLink`, `<Select>` and `<Bleed>` from `nextra-theme-docs` to
  `nextra/components`
- 283320f: remove `<Th>`, `<Tr>` and `<Td>` exports (since they should be always
  used with `<Table>` component)

  ```diff
  - import { Table, Th, Tr, Td } from 'nextra/components'
  + import { Table } from 'nextra/components'

  // ...

  - <Th>
  + <Table.Th>
  - <Tr>
  + <Table.Tr>
  - <Td>
  + <Table.Td>
  ```

- 283320f: make `compileMdx` from `nextra/compile` return a `string` instead of
  an `object`
- 283320f: remove `export const title` from generated mdx pages
- 283320f: The initial version which supports App Router instead of Pages
  Router, something may be broken, check
  https://github.com/shuding/nextra/tree/v4-v2/examples for the migration guide
- 283320f: fix focusing on first search result item
- 283320f: rename `nextra/mdx` to `nextra/mdx-components`
- 283320f: migrate search from Flexsearch to Pagefind
- 283320f: remove `nextra/remote`, `nextra/schemas` and `nextra/remark-plugins`
- 283320f: - add root `_meta.global.{js,jsx,ts,tsx}` file
  > See
  > [working example](https://github.com/shuding/nextra/blob/v4-v2/docs/app/_meta.global.ts)
  > based on https://nextra.site website
  - `getPageMap` now receive only 1 argument `root?: string = '/'` instead of 2
    `lang?: string, route?: string = '/'`
  - remove `createCatchAllMeta` from `nextra/catch-all`
  - remove `collectCatchAllRoutes`
  - remove `normalizePageRoute`
  - add `mergeMetaWithPageMap` to `nextra/page-map`
  - move adding `metadata.filePath`, `metadata.title` and `metadata.readingTime`
    in remark plugin
  - refactor recma rewrite plugin and add tests
    - remove `recmaRewriteJsx`
    - remove `recmaRewriteFunctionBody`
  - make `convertPageMapToJs` sync
- 283320f: improve performance on projects without Turbopack enabled
- 283320f: release Nextra rc.0
- 283320f: - migrate to tailwind css v4.beta2
  - refactor builtin CSS classes from `_` prefix to `x:` prefix
  - remove `color-primary-750` theme color variant
- 283320f: replace `export const useTOC = () = [/* your headings */]` by
  `export const toc = [/* your headings */]`
- 283320f: move `<Head>` component in `nextra/components`
- 283320f: remove `renderComponent` and `renderString`
- 283320f: require Next.js minimum v14
- 283320f: - add `nextra/components` to `experimental.optimizePackageImports` to
  optimize `nextra/components` by default
  - remove `<RemoteContent>` from `nextra/components`
  - rename `<RemoteContent>` to `MDXRemote` and move to `nextra/mdx-remote`

### Minor Changes

- 283320f: - use ReactIcon for code blocks with `jsx`, `tsx` language
  - add JsonIcon for `json` language
  - parse language from filename if exist when `diff` language is specified
  - use JavaScript icon for `cjs` and `mjs`
  - use TypeScript icon for `cts` and `mts`
- 283320f: replace `useContentDir` with `contentDirBasePath` option which
  configure `content` directory under a catch-all subdirectory
- 283320f: move TOC logic from `recma-rewrite-jsx` plugin to
  `rehype-extract-toc-content` plugin
- 283320f: make `page.{jsx,tsx,mdx}` pages and `_meta` files from `app` dir, and
  also `content` folder files - all add to `pageMap`, but ignore dynamic pages
  `[[`
- e11dbe0: set `content` value for `<meta name="theme-color">` based on
  background value for light and dark themes
- 283320f: compile `nextra/components`, `nextra/hooks`, `nextra-theme-docs` and
  `nextra-theme-blog` source code with react-compiler

### Patch Changes

- 283320f: improve `generatePageMap` types
- 283320f: search tweaks
- fdd2c6a: fix steps background on dark mode fix headings anchor link color on
  dark mode
- 283320f: setup `@typescript-eslint/no-unnecessary-condition` rule and fix
  warnings
- aca79fa: Don't focus search input on `Ctrl + k` on non Mac devices. Don't
  focus search input on `⌘ + Shift + k` or `Ctrl + Shift + k`.
- 283320f: add helpful error message about not available search on development
  mode
- 283320f: add `getPageMap` helper function to `nextra/page-map`
- 283320f: Fixes when Turbopack is enabled:
  `Module not found: Can't resolve '@theguild/remark-mermaid/mermaid'`
- 283320f: add `whiteListTagsStyling` nextra config option
- 283320f: fix unable to select text and `::selection` style
- 283320f: - allow override/add additional icons for code blocks
  - remove `nextraConfig.mdxOptions.providerImportSource` option in favour of
    `mdx-components` file
- 283320f: - Use Tailwind CSS CLI because CSS processing by `tsup` produce
  different, weird and broken result
  - Patch react-compiler with some fixes which isn't fixed
- 283320f: use `Date.now()` for last edit time on development and git last
  commit time on production
- 283320f: move `pagefind` output to `public/_pagefind` directory
  https://github.com/shuding/nextra/pull/3517
- 283320f: initialize `transformerTwoslash` only 1 time outside of loader
- 283320f: remove `NextraConfig.transformPageMap`
- 283320f: - remove `nextra/context`
  - remove `type NextraThemeLayoutProps`
- 283320f: Export Meta type from schemas
- 283320f: fix edit on github and last updated at for catch all routes
- 283320f: simplify `generatePageMap`
- 283320f: add icons for `javascript and `typescript langs
- 283320f: - parse and transform `_meta` files with zod
  - remove `_meta` `newWindow` field
- 283320f: sync with nextra 3.1.0
- 283320f: Cache the result of `repository.getFileLatestModifiedDateAsync`
  because it can slow down Fast Refresh for uncommitted files.
- 283320f: add `bottomContent` prop for `<Wrapper>` component, e.g. to put some
  content after pagination in `nextra-theme-docs`
- 283320f: select tab with active hash and scroll to right heading
- 283320f: adjust RegEx for folder groups in app router
- 283320f: - do not treat `content/page.{mdx,md}` as index page
  - skip visiting directories which starts with underscore for `app` directory
- 283320f: reduce bundle size of bundled website by compiling svg icons in
  separated files
- 283320f: enable page reload of catch-all routes `app/[[...slug]].jsx` on
  content change
- 283320f: move `createCatchAllMeta` from `nextra/catch-all` to
  `nextra/page-map`
- 283320f: remove false positive warnings on projects without `content/`
  directory

  ```
  ⚠ Compiled with warnings

  ../packages/nextra/dist/client/pages.js
  Module not found: Can't resolve 'private-next-root-dir/content' in '/Users/dmytro/Desktop/nextra/packages/nextra/dist/client'
  ```

- 283320f: Fix `MetaRecord` type so it's no longer `unknown`
- 283320f: fix error goes from `playground.js` file when your `mdx-components`
  file contain server-only components

  ```
  ./app/layout.tsx
  'client-only' cannot be imported from a Server Component module. It should only be used from a Client Component.

  Import trace for requested module:
  ../packages/components/dist/index.js
  ./mdx-components.js
  ../node_modules/.pnpm/nextra@4.0.0-app-router.20_@types+react@18.3.12_acorn@8.14.0_next@15.0.2_@babel+core@7.26.0_r_73lkrljx3r7g5vsm2cmbm3erma/node_modules/nextra/dist/client/components/remote-content.js
  ../node_modules/.pnpm/nextra@4.0.0-app-router.20_@types+react@18.3.12_acorn@8.14.0_next@15.0.2_@babel+core@7.26.0_r_73lkrljx3r7g5vsm2cmbm3erma/node_modules/nextra/dist/client/components/playground.js
  ```

- 283320f: - sync with nextra 3.0.15
  - bump to Next 15
  - remove importing of `style.css` in themes, you need to import now manually
    by

  ```js
  import 'nextra-theme-docs/style.css' // for docs theme
  import 'nextra-theme-blog/style.css' // for blog theme
  ```

- 283320f: add `normalizePagesResult.activeMetadata` to get value of front
  matter or exported metadata from page
- 283320f: add support for turbopack `next dev --turbopack`
- 283320f: fix `colorSchema` for HEX format with 4 chars, e.g. `#111`
- 283320f: fix external svg icon was added for span in `<Anchor>`
- 283320f: remove `NormalizedResult.flatDirectories`

  remove `Item.withIndexPage`, use `'frontMatter' in Item`

- 283320f: sync with nextra 3.0.10
- 283320f: optimize compiled svg icons with react-compiler
- 283320f: - simplify `generatePageMapFromFilepaths`
  - sync with nextra 3.2.0
- 283320f: defer pagefind results update for prioritizing the user input state
- 283320f: make Nextra works with `src/app` and `src/content` directories
- 283320f: - fix missing tailwind class for `json` icon in code blocks
  - capitalize folders in sidebar even without index pages
  - sync with nextra 3.2.4
- 283320f: add ↗ char for external links
- 283320f: remove check for filepaths outside cwd in `compileMdx`
- 283320f: sync with nextra 3.0.3
- 283320f: fix injecting mdx-components into headings and injecting into toc
- 283320f: - add `disabled` prop for `<Folder>` component when `open` prop was
  set (to disable click event and remove `cursor: pointer`)
  - allow `<h5>` and `<h6>` tags be used with `<Steps>`
  - fix Webpack module rebuild for pageMap when new files where added or removed
    in `app` dir or `content` dir
- 283320f: fix TypeError: Cannot read properties of undefined (reading 'id')
  when importing partial MDX
- 283320f: `firstChildRoute` should return "index" route as first
- 283320f: Use `primaryColor` for `::selection` styles
- 283320f: replace `nextraConfig.mdxBaseDir: string` by `useContentDir: boolean`
- 283320f: support `GitHub Alert Syntax`
- 283320f: fix search, didn't work with Next.js' `basePath` set
- 283320f: make `<SkipNavContent>` as server component
- 283320f: Allow `type: 'separator'` item as `items` for `type: 'menu'`

## 4.0.0-rc.0

### Major Changes

- 28796b4: release Nextra rc.0

## 4.0.0-app-router.43

### Patch Changes

- 50c2f76: add `bottomContent` prop for `<Wrapper>` component, e.g. to put some
  content after pagination in `nextra-theme-docs`
- 50c2f76: fix `colorSchema` for HEX format with 4 chars, e.g. `#111`

## 4.0.0-app-router.42

### Patch Changes

- 242e0d0: search tweaks
- 3fc12a0: - Use Tailwind CSS CLI because CSS processing by `tsup` produce
  different, weird and broken result
  - Patch react-compiler with some fixes which isn't fixed

## 4.0.0-app-router.41

## 4.0.0-app-router.40

### Patch Changes

- 88135ec: Fix `MetaRecord` type so it's no longer `unknown`

## 4.0.0-app-router.39

### Patch Changes

- 711dbe7: add icons for `javascript and `typescript langs

## 4.0.0-app-router.38

### Patch Changes

- 42eb445: remove check for filepaths outside cwd in `compileMdx`

## 4.0.0-app-router.37

### Patch Changes

- ad80ee1: fix TypeError: Cannot read properties of undefined (reading 'id')
  when importing partial MDX

## 4.0.0-app-router.36

### Patch Changes

- 739e9eb: Export Meta type from schemas
- d805f2a: adjust RegEx for folder groups in app router
- 0ab4ff1: optimize compiled svg icons with react-compiler

## 4.0.0-app-router.35

### Patch Changes

- 96fb083: select tab with active hash and scroll to right heading

## 4.0.0-app-router.34

## 4.0.0-app-router.33

### Patch Changes

- dd2e216: Allow `type: 'separator'` item as `items` for `type: 'menu'`

## 4.0.0-app-router.32

### Patch Changes

- fbeef15: setup `@typescript-eslint/no-unnecessary-condition` rule and fix
  warnings

## 4.0.0-app-router.31

### Minor Changes

- 386b620: compile `nextra/components`, `nextra/hooks`, `nextra-theme-docs` and
  `nextra-theme-blog` source code with react-compiler

## 4.0.0-app-router.30

### Patch Changes

- f277a7a: fix search, didn't work with Next.js' `basePath` set

## 4.0.0-app-router.29

### Major Changes

- 4bdf82d: - migrate to tailwind css v4.beta2
  - refactor builtin CSS classes from `_` prefix to `x:` prefix
  - remove `color-primary-750` theme color variant

## 4.0.0-app-router.28

### Patch Changes

- 846552e: - fix missing tailwind class for `json` icon in code blocks
  - capitalize folders in sidebar even without index pages
  - sync with nextra 3.2.4

## 4.0.0-app-router.27

### Major Changes

- 8a0ae0f: - add root `_meta.global.{js,jsx,ts,tsx}` file
  > See
  > [working example](https://github.com/shuding/nextra/blob/v4-v2/docs/app/_meta.global.ts)
  > based on https://nextra.site website
  - `getPageMap` now receive only 1 argument `root?: string = '/'` instead of 2
    `lang?: string, route?: string = '/'`
  - remove `createCatchAllMeta` from `nextra/catch-all`
  - remove `collectCatchAllRoutes`
  - remove `normalizePageRoute`
  - add `mergeMetaWithPageMap` to `nextra/page-map`
  - move adding `metadata.filePath`, `metadata.title` and `metadata.readingTime`
    in remark plugin
  - refactor recma rewrite plugin and add tests
    - remove `recmaRewriteJsx`
    - remove `recmaRewriteFunctionBody`
  - make `convertPageMapToJs` sync

### Patch Changes

- 5e06f57: fix injecting mdx-components into headings and injecting into toc

## 4.0.0-app-router.26

### Minor Changes

- 0076bad: move TOC logic from `recma-rewrite-jsx` plugin to
  `rehype-extract-toc-content` plugin

### Patch Changes

- be82724: Fixes when Turbopack is enabled:
  `Module not found: Can't resolve '@theguild/remark-mermaid/mermaid'`

## 4.0.0-app-router.25

### Major Changes

- c095f98: make `compileMdx` from `nextra/compile` return a `string` instead of
  an `object`
- 79bbab7: remove `export const title` from generated mdx pages
- 33ee518: replace `export const useTOC = () = [/* your headings */]` by
  `export const toc = [/* your headings */]`

### Patch Changes

- 3edc6d7: use `Date.now()` for last edit time on development and git last
  commit time on production
- fdbae45: initialize `transformerTwoslash` only 1 time outside of loader

## 4.0.0-app-router.24

### Patch Changes

- e46dbdf: Cache the result of `repository.getFileLatestModifiedDateAsync`
  because it can slow down Fast Refresh for uncommitted files.

## 4.0.0-app-router.23

### Patch Changes

- b2e44d3: make Nextra works with `src/app` and `src/content` directories

## 4.0.0-app-router.22

### Patch Changes

- 5f79b77: fix unable to select text and `::selection` style
- 57fde3f: reduce bundle size of bundled website by compiling svg icons in
  separated files

## 4.0.0-app-router.21

### Major Changes

- 730899e: - add `nextra/components` to `experimental.optimizePackageImports` to
  optimize `nextra/components` by default
  - remove `<RemoteContent>` from `nextra/components`
  - rename `<RemoteContent>` to `MDXRemote` and move to `nextra/mdx-remote`

### Patch Changes

- 4e02ef3: fix error goes from `playground.js` file when your `mdx-components`
  file contain server-only components

  ```
  ./app/layout.tsx
  'client-only' cannot be imported from a Server Component module. It should only be used from a Client Component.

  Import trace for requested module:
  ../packages/components/dist/index.js
  ./mdx-components.js
  ../node_modules/.pnpm/nextra@4.0.0-app-router.20_@types+react@18.3.12_acorn@8.14.0_next@15.0.2_@babel+core@7.26.0_r_73lkrljx3r7g5vsm2cmbm3erma/node_modules/nextra/dist/client/components/remote-content.js
  ../node_modules/.pnpm/nextra@4.0.0-app-router.20_@types+react@18.3.12_acorn@8.14.0_next@15.0.2_@babel+core@7.26.0_r_73lkrljx3r7g5vsm2cmbm3erma/node_modules/nextra/dist/client/components/playground.js
  ```

- 0d74f68: fix external svg icon was added for span in `<Anchor>`

## 4.0.0-app-router.20

### Major Changes

- 16816f2: remove `<Th>`, `<Tr>` and `<Td>` exports (since they should be always
  used with `<Table>` component)

  ```diff
  - import { Table, Th, Tr, Td } from 'nextra/components'
  + import { Table } from 'nextra/components'

  // ...

  - <Th>
  + <Table.Th>
  - <Tr>
  + <Table.Tr>
  - <Td>
  + <Table.Td>
  ```

- aa94d91: rename `nextra/mdx` to `nextra/mdx-components`
- 0a63ba3: improve performance on projects without Turbopack enabled

### Patch Changes

- 3d8705c: improve `generatePageMap` types
- 27454c4: remove `NextraConfig.transformPageMap`
- 7cc8ca1: simplify `generatePageMap`
- 71a051b: - do not treat `content/page.{mdx,md}` as index page
  - skip visiting directories which starts with underscore for `app` directory
- 0a63ba3: move `createCatchAllMeta` from `nextra/catch-all` to
  `nextra/page-map`
- 16816f2: remove false positive warnings on projects without `content/`
  directory

  ```
  ⚠ Compiled with warnings

  ../packages/nextra/dist/client/pages.js
  Module not found: Can't resolve 'private-next-root-dir/content' in '/Users/dmytro/Desktop/nextra/packages/nextra/dist/client'
  ```

- b873702: `firstChildRoute` should return "index" route as first

## 4.0.0-app-router.19

### Patch Changes

- a3627e5: - simplify `generatePageMapFromFilepaths`
  - sync with nextra 3.2.0

## 4.0.0-app-router.18

### Minor Changes

- 439466a: replace `useContentDir` with `contentDirBasePath` option which
  configure `content` directory under a catch-all subdirectory
- b00a560: make `page.{jsx,tsx,mdx}` pages and `_meta` files from `app` dir, and
  also `content` folder files - all add to `pageMap`, but ignore dynamic pages
  `[[`

### Patch Changes

- a074a99: add `whiteListTagsStyling` nextra config option

## 4.0.0-app-router.17

### Patch Changes

- 33568c1: add `normalizePagesResult.activeMetadata` to get value of front
  matter or exported metadata from page

## 4.0.0-app-router.16

### Minor Changes

- ab21db7: - use ReactIcon for code blocks with `jsx`, `tsx` language
  - add JsonIcon for `json` language
  - parse language from filename if exist when `diff` language is specified
  - use JavaScript icon for `cjs` and `mjs`
  - use TypeScript icon for `cts` and `mts`

### Patch Changes

- 0540e6c: - add `disabled` prop for `<Folder>` component when `open` prop was
  set (to disable click event and remove `cursor: pointer`)
  - allow `<h5>` and `<h6>` tags be used with `<Steps>`
  - fix Webpack module rebuild for pageMap when new files where added or removed
    in `app` dir or `content` dir
- 5b47509: make `<SkipNavContent>` as server component

## 4.0.0-app-router.15

## 4.0.0-app-router.14

### Major Changes

- be19dd4: remove `"typesVersions"` field from `package.json`. You need to set
  `"moduleResolution": "bundler"` in your `tsconfig.json` if you are using
  TypeScript

## 4.0.0-app-router.13

### Major Changes

- 54657e2: require Next.js minimum v15

### Patch Changes

- 3ade013: - remove `nextra/context`
  - remove `type NextraThemeLayoutProps`
- ddc39cc: - parse and transform `_meta` files with zod
  - remove `_meta` `newWindow` field
- 07213e2: add support for turbopack `next dev --turbopack`

## 4.0.0-app-router.12

### Patch Changes

- b8defc9: sync with nextra 3.1.0
- b8defc9: remove `NormalizedResult.flatDirectories`

  remove `Item.withIndexPage`, use `'frontMatter' in Item`

## 4.0.0-app-router.11

### Patch Changes

- be15165: move `pagefind` output to `public/_pagefind` directory
  https://github.com/shuding/nextra/pull/3517

## 4.0.0-app-router.10

### Patch Changes

- 8b1a7c9: defer pagefind results update for prioritizing the user input state

## 4.0.0-app-router.9

### Patch Changes

- 2c8a8ab: - sync with nextra 3.0.15
  - bump to Next 15
  - remove importing of `style.css` in themes, you need to import now manually
    by

  ```js
  import 'nextra-theme-docs/style.css' // for docs theme
  import 'nextra-theme-blog/style.css' // for blog theme
  ```

## 4.0.0-app-router.8

### Patch Changes

- 9832af9: add ↗ char for external links
- ec39959: Use `primaryColor` for `::selection` styles
- 875842b: support `GitHub Alert Syntax`

## 4.0.0-app-router.7

### Patch Changes

- 5201e5f: add helpful error message about not available search on development
  mode
- 3ac2c32: add `getPageMap` helper function from `nextra/page-map`
- b4ca36d: - allow override/add additional icons for code blocks
  - remove `nextraConfig.mdxOptions.providerImportSource` option in favour of
    `mdx-components` file
- 4768dee: replace `nextraConfig.mdxBaseDir: string` by `useContentDir: boolean`

## 4.0.0-app-router.6

### Patch Changes

- 2092d5e: enable page reload of catch-all routes `app/[[...slug]].jsx` on
  content change
- a97e5cf: sync with nextra 3.0.10

## 4.0.0-app-router.5

### Patch Changes

- 659b36e: remove `jsx-runtime.cjs`, import runtime from 'react/jsx-runtime'
- a15a02d: sync with nextra 3.0.3

## 4.0.0-app-router.4

## 4.0.0-app-router.3

### Major Changes

- 1e77fab: move `<Collapse>`, `<Details>`, `<Summary>`, `<SkipNavContent>`,
  `SkipNavLink`, `<Select>` and `<Bleed>` from `nextra-theme-docs` to
  `nextra/components`
- 1e77fab: remove `nextra/remote`, `nextra/schemas` and `nextra/remark-plugins`
- 1e77fab: remove `renderComponent` and `renderString`

### Patch Changes

- 1e77fab: fix edit on github and last updated at for catch all routes

## 4.0.0-app-router.2

### Major Changes

- 215aa08: fix focusing on first search result item
- 8ef0f58: move `<Head>` component in `nextra/components`

## 4.0.0-app-router.1

### Major Changes

- 26851b5: migrate search from Flexsearch to Pagefind

## 4.0.0-app-router.0

### Major Changes

- 99f34d3: The initial version which supports App Router instead of Pages
  Router, something may be broken, check
  https://github.com/shuding/nextra/tree/v4-v2/examples for the migration guide

## 3.3.1

### Patch Changes

- bfa61d9: add `text-overflow: ellipsis` for `<Cards.Card>` component

## 3.3.0

### Minor Changes

- ee69234: add
  [image zoom feature](http://nextra.site/docs/guide/image#image-zoom) for all
  images written via [GFM syntax](https://github.github.com/gfm/#images) in
  md/mdx files (except images inside links)

## 3.2.5

### Patch Changes

- 2f5d954: fix unable override injected `img` component

## 3.2.4

### Patch Changes

- a4b0bbb: fix(deps): update dependency title to v4

  > This fix ReDoS vulnerability exposed via title → clipboardy → execa →
  > cross-spawn dependency chain

## 3.2.3

### Patch Changes

- 50f33f3: Add tabClassName to Tabs props

## 3.2.2

### Patch Changes

- 45cccd4: allow passing `className` for `<Tabs>` and `<Tabs.Tab>`

## 3.2.1

## 3.2.0

## 3.1.3

### Patch Changes

- 6e64b16: fix
  `Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in /path/to/project/node_modules/nextra/package.json`
  when using `next.config.ts`
- d44c4bc: requires to have a custom App component (`pages/_app.jsx`)
- 24f9806: fix folder's index page was not merged with folder itself for some
  edge case

## 3.1.2

### Patch Changes

- 9c78588: fix(loader): Prevent overwriting of
  `rehypePrettyCodeOptions.transformer`

## 3.1.1

### Patch Changes

- 68633e5: fix: Improve Twoslash Popover Display

## 3.1.0

### Minor Changes

- 8e9767e: `activeType` should be initialized from `meta['*']`
- fec399a: fix `type: 'separator'`, `type: 'menu'` and `item` with `href` not
  respecting order when not all pages specified in `_meta` file

### Patch Changes

- 035fe48: - fix empty dropdown menu when \_meta item with `type: "menu"`
  contains items with local pages
- c002118: - add tests for should respect order for `type: "separator"`,
  `type: "menu"` and item with `href`

## 3.1.0-canary.1

### Minor Changes

- 8e9767e: `activeType` should be initialized from `meta['*']`

### Patch Changes

- 035fe48: - fix empty dropdown menu when \_meta item with `type: "menu"`
  contains items with local pages
- c002118: - add tests for should respect order for `type: "separator"`,
  `type: "menu"` and item with `href`

## 3.1.0-canary.0

### Minor Changes

- fec399a: fix `type: 'separator'`, `type: 'menu'` and `item` with `href` not
  respecting order when not all pages specified in `_meta` file

## 3.0.15

### Patch Changes

- bd498c6: fix compatibility with Next.js `15.0.0-rc.1`

## 3.0.14

### Patch Changes

- 6454938: update css selectors for `<code>`, use `code.nextra-code`
- 9794e9e: update package version range for `@theguild/remark-mermaid` to be at
  least `^0.1.3`
  https://github.com/nextauthjs/next-auth/pull/12029#discussion_r1801785960
- 9794e9e: Fix `frontMatter.sidebarTitle` didn't affect without
  `frontMatter.title` set

  now priority for sidebar title is:
  1. `title` property from `_meta` file
  1. `frontMatter.sidebarTitle`
  1. `frontMatter.title`
  1. formatted with [Title](https://title.sh) based on filename

## 3.0.13

## 3.0.12

### Patch Changes

- 7e0093f: Fix `nextra/locales` middleware, redirect to the docs URL relative to
  the `/<basePath>`.

## 3.0.11

### Patch Changes

- e0a9303: add `nextra/locales` middleware which can be exported from
  `root-of-your-project/middleware.{js,ts}` file to detect and redirect to the
  user-selected language for i18n websites

## 3.0.10

### Patch Changes

- 31de764: another attempt to fix:

  ```
  Failed to compile.

  ./node_modules/typescript/lib/typescript.js
  Module not found: Can't resolve 'module'
  ```

- 161d350: fix `Could not find a declaration file for module 'nextra'`

## 3.0.9

### Patch Changes

- f9cc160: - fix `Module not found: Can't resolve 'module'` in yarn@4.5.0
  - disable `twoslash` in browser because he never worked in this environment

## 3.0.8

## 3.0.7

### Patch Changes

- 4bbc1fe: apply user's `recmaPlugins` first

## 3.0.6

## 3.0.5

## 3.0.4

### Patch Changes

- 84a8a41: use 3 nextra's webpack loaders instead of 4
- 659b36e: remove `jsx-runtime.cjs`, import runtime from 'react/jsx-runtime'
- 84fc255: should get right `activeType`, `activeThemeContext` even when some
  parent has `display: 'hidden'`

## 3.0.3

### Patch Changes

- 82fc267: remove
  `Critical dependency: the request of a dependency is an expression` warnings
- edc6c29: remove `truthy()` helper function
- 9d93caf: RTL support for the `<Steps>` component.
- 5fbce2f: Added golang logo for code blocks.

## 3.0.2

### Patch Changes

- b6341f7: remove warning
  `Watchpack Error (initial scan): Error: ENOTDIR: not a directory, scandir 'path-to-your-node_modules/next/dist/pages/_app.js'`

## 3.0.1

## 3.0.0

### Major Changes

- e7e8e84: show react components, variable interpolation and latex in toc
- 7188278: - insert `frontMatter` as export node via custom remark plugin
  - remove `frontMatter.mdxOptions` support

- 023d37b: add `"type": "module"` to `nextra` package
- 50a52fd: - ❌ remove `_app.mdx`, use `_app.{js,jsx}` or `_app.{ts,tsx}` for
  TypeScript projects instead
  - ❌ remove Nextra middleware `nextra/locales`
  - ❌ remove `parseFileName` from `nextra/utils`
  - ❌ remove `nextra/filter-route-locale`
  - ❌ remove `resolvePageMap` and `pageMapCache` from `nextra/page-map`
  - ❌ remove `__nextraPageOptions.pageNextRoute`
  - ❌ remove `pageOpts.route` and `pageOpts.newNextLinkBehavior`
  - ❌ remove `LoaderOptions.defaultLocale`
  - ❌ remove `__nextra_internal__.context[route].themeConfig`
  - ✅ add `nextra/fetch-filepaths-from-github`
  - save `pageMap` to `.next/static/chunks/nextra-page-map-{locale}.mjs`
  - save `fileMap` to `.next/static/chunks/nextra-file-map.mjs`

- c2ad837: update to MDX3
- 148278c: rename tailwind prefix `nx-` to `_` to reduce bundle size
- 919fe97: set `"peerDependencies.next": ">=13"`
- 47b125d: fix global style conflicts for
  `<a>`/`<button>`/`<summary>`/`<input>`/`[tabindex]:not([tabindex='-1']`
- ba30c6c: use render props for className with `selected`, `disabled` and
  `hover` state for `<Tab>`
- d7d8a3e: new styles for code blocks aka in next.js
- 2872606: remove `image` prop from `<Card>` component, image will be showed
  based on truthiness `children` prop now

  set `icon` as optional prop

- 63ca28b: Remove support of "\_meta.json", use "\_meta.{js,jsx,ts,tsx}"
  instead.
- ad4823d: add zod validation for nextraConfig
- ab07609: remove `locale` and `defaultLocale` from `normalizePages`
- 2f3be33: - set `"engines.node": ">=18"`
  - remove `Tab` export, use `Tabs.Tab` instead
  - remove `Card` export, use `Cards.Card` instead
  - disallow import md/mdx files that are outside the working directory, use
    symlinks instead

- 66cce1d: **BREAKING** bundle to ESM only

  > ⚠️⚠️⚠️ use `next.config.mjs` or `next.config.js` with `"type": "module"`

- b9f88e3: - remove `use-internals.ts`
  - remove `layout.tsx`, move directly to `setup-page.tsx`
  - remove `kind: 'Meta' | 'Folder' | 'MdxPage'` to keep page map smaller

- 128e195: fix React warning, remove PageOpts.toc, use `toc` prop from
  `components.wrapper`
- 576cb6f: - rename `nextraConfig.flexsearch` to `nextraConfig.search`
- 1f3e7cd: - remove `__nextraPageOptions.hot`
  - remove `__nextraPageOptions.pageOptsChecksum`
  - remove `__nextra_internal__.refreshListeners` (no longer needed since we
    insert toc as esm node in remark plugin)
  - remove `hashFnv32a`

- 198dbcc: use toc with JSX elements for remote content
- 191e6c4: - use `shikiji` instead of `shiki`
  - rename `useSSG` to `useData`

- c7f03e5: rename `pageOpts.headings` to `toc`

### Minor Changes

- 0fe55db: add `import { useRouter } from 'nextra/hooks'` for fetching `locale`
  and `defaultLocale`
- 6ec3241: Add Terraform/Move icon https://github.com/shuding/nextra/pull/2811
  https://github.com/shuding/nextra/pull/2808
- c7f03e5: should not add virtual `_meta` file if missing
- 3644e1c: add `remark-smartypants`
- 5a63701: add icons for following languages:
  - GraphQL (`graphql`)
  - C++ (`c++`, `cpp`)
  - C# (`csharp`, `c#`, `cs`)
  - Python (`python`, `py`)

  allow disallow mobile word wrap button in code blocks with `word-wrap=false`
  meta data setting

- 60ec68c: improvements for remarkStaticImage:
  - import same image only once
  - support importing images by markdown image definitions

- a52a869: add `frontmatter.sidebarTitle` support for setting page label in
  sidebar via frontmatter
- 6ec3241: Make the `<Tab>` component be crawlable and indexable by search
  engines by default
- f71e660: change to shiki again
- 6070b02: rename `frontmatter.sidebar_label` to `frontmatter.sidebarTitle`
- 4e55c06: add support for `_meta.{js,jsx,ts,tsx}` with JSX support
- 8bce16d: replace `transformPageOpts` nextra option by `transformPageMap`
- 3043826: add shikiji twoslash

  Demo feature:
  https://nextra-v2-na3obnhub-shuding1.vercel.app/docs/guide/twoslash-support

- 6070b02: move `removeLinks` function from `nextra-theme-docs` to
  `nextra/remove-links`
- 440ff42: add MathJax support

### Patch Changes

- d1e3e9a: handle case when meta object was added in `transformPageMap`
- 73239c4: To ensure consistent horizontal padding, set the default language as
  plaintext for code blocks. This prevents any loss of formatting for code
  blocks without a specified language.
- 2b9b95b: migrate to `@headlessui/react` v2
- 2a3e3e7: Fix first list item in `<FileTree>` not within permitted parent
  elements
- a3b67ae: `_meta` should return
  `export const getStaticProps = () => ({ notFound: true })` for static exports,
  instead of page without contain
- 1a36469: add `frontMatter.sidebarTitle` only if `frontMatter.title` is empty
- 799174f: fixed creating `pageMap` items for folders with dots

  remove requirement of passing `filePaths` with `.md`/`.mdx` extensions for
  `createCatchAllMeta` function

- 98f439c: export `evaluate` function for remote content
- cb24790: fix broken `export default` statement in mdx files
- 982862f: Support for `h2` and `h4` Markdown headings with the Steps component.
- a8c2196: use dynamic import for loading `mermaid`
- 0b5cc9d: make nextra compatible with windows
- fe5061b: fix for remote docs
- 1a634cd: remove explicit `ZodError` assertion
- ad108ff: use `overflow-x-auto` instead `overflow-x-scroll` for `<Table>`
- 4f0f6b2: Omit `...{:type}` inline code annotations from search index #2922
- 1f3e7cd: fix `pageProps` for NextraLayout
- 90c129e: children in Card component is required only if the image prop is true
- 150184b: attach heading anchor `id` attribute to heading (like Pagefind do)
  and fix heading anchor styles when `theme.typesetting: 'article'` is set
- c74ae90: Fix TypeError: \_jsx is not a function for remote content on
  development environment
- 7615b62: fix `useRouter` in `nextra/hooks`, use `asPath` instead `route`
  because locale can be dynamic `/[locale]`
- 7bb18e3: Add a generic for `themeConfig` in `NextraThemeLayoutProps` to
  improve type inference.
- 8efbb45: remove `nextra/data` export, move `useData` to `nextra/hooks`,
  `RemoteContent` to `nextra/components`
- 6f4c83a: fix unclickable links in TOC

  allow passing `recmaPlugins` in `mdxOptions`

- d8a406b: add `"sideEffects": false` for better tree-shaking
- 9f55bd1: update rehype-pretty-code/shikiji to latest
- ccaf3d4: Add the `autoImportThemeStyle` option to the Nextra configuration.
  This allows users to import the official Nextra theme CSS into a specific
  cascade layer.
- 2630461: fix
  `TypeError: undefined is not iterable (cannot read property Symbol(Symbol.iterator))`
  on dev environment when `frontMatter.searchable: false`
- 217f708: update next-themes

  fix wrong numbering for nested `<Steps>`

- 57bc0e2: fix reload of nextra layout on route change, reported by sound.xyz
- ca51306: Enhance focus ring style consistency.
- f662237: avoid focus-visible style being cut off by overflow-hidden
- 3c6193d: Remove unnecessary `sortPages` from `server/utils.ts`
- 363b85f: add `flex-shrink: 0` for indent in `FileTree` for `<Ident>` and svg
  icons in `<Folder>` and `<File>`
- fef635e: ignore loading pageMap for dynamic locale `/[locale]`
- 237c345: Make React 18 as minimal requirement
- 7faa096: fix visible hidden pages on mobile which set up with
  `display: 'hidden'`
- 9099c35: remove `nextra/mdx-plugins`, add `nextra/remark-plugins`
- 98f439c: add rust icon
- a95e745: Fix the line highlighting background-color does not extend to the
  full width of the code block when a scrollbar appears with line numbers.
- 80e11e0: move `resolvePageMap` to `nextra/page-map-dynamic`

## 3.0.0-alpha.42

### Patch Changes

- ca51306: Enhance focus ring style consistency.

## 3.0.0-alpha.41

### Patch Changes

- 237c345: Make React 18 as minimal requirement

## 3.0.0-alpha.40

### Patch Changes

- 982862f: Support for `h2` and `h4` Markdown headings with the Steps component.

## 3.0.0-alpha.39

### Major Changes

- 47b125d: fix global style conflicts for
  `<a>`/`<button>`/`<summary>`/`<input>`/`[tabindex]:not([tabindex='-1']`
- ba30c6c: use render props for className with `selected`, `disabled` and
  `hover` state for `<Tab>`
- 2872606: remove `image` prop from `<Card>` component, image will be showed
  based on truthiness `children` prop now

  set `icon` as optional prop

## 3.0.0-alpha.38

### Patch Changes

- ccaf3d4: Add the `autoImportThemeStyle` option to the Nextra configuration.
  This allows users to import the official Nextra theme CSS into a specific
  cascade layer.

## 3.0.0-alpha.37

### Patch Changes

- 2a3e3e7: Fix first list item in `<FileTree>` not within permitted parent
  elements

## 3.0.0-alpha.36

### Patch Changes

- 2b9b95b: migrate to `@headlessui/react` v2

## 3.0.0-alpha.35

### Patch Changes

- f662237: avoid focus-visible style being cut off by overflow-hidden

## 3.0.0-alpha.34

### Patch Changes

- 1a634cd: remove explicit `ZodError` assertion

## 3.0.0-alpha.33

### Patch Changes

- 7bb18e3: Add a generic for `themeConfig` in `NextraThemeLayoutProps` to
  improve type inference.

## 3.0.0-alpha.32

### Patch Changes

- 73239c4: To ensure consistent horizontal padding, set the default language as
  plaintext for code blocks. This prevents any loss of formatting for code
  blocks without a specified language.
- 799174f: fixed creating `pageMap` items for folders with dots

  remove requirement of passing `filePaths` with `.md`/`.mdx` extensions for
  `createCatchAllMeta` function

- 150184b: attach heading anchor `id` attribute to heading (like Pagefind do)
  and fix heading anchor styles when `theme.typesetting: 'article'` is set
- 3c6193d: Remove unnecessary `sortPages` from `server/utils.ts`

## 3.0.0-alpha.31

### Patch Changes

- d1e3e9a: handle case when meta object was added in `transformPageMap`

## 3.0.0-alpha.30

### Patch Changes

- 7615b62: fix `useRouter` in `nextra/hooks`, use `asPath` instead `route`
  because locale can be dynamic `/[locale]`

## 3.0.0-alpha.29

### Patch Changes

- fef635e: ignore loading pageMap for dynamic locale `/[locale]`

## 3.0.0-alpha.28

### Patch Changes

- a8c2196: use dynamic import for loading `mermaid`
- 363b85f: add `flex-shrink: 0` for indent in `FileTree` for `<Ident />` and svg
  icons in `<Folder />` and `<File />`

## 3.0.0-alpha.27

### Patch Changes

- 4f0f6b27: Omit `...{:type}` inline code annotations from search index #2922
- a95e7454: Fix the line highlighting background-color does not extend to the
  full width of the code block when a scrollbar appears with line numbers.

## 3.0.0-alpha.26

## 3.0.0-alpha.25

## 3.0.0-alpha.24

### Patch Changes

- 6f4c83a8: fix unclickable links in TOC

  allow passing `recmaPlugins` in `mdxOptions`

## 3.0.0-alpha.23

### Minor Changes

- 6ec3241c: Add Terraform/Move icon https://github.com/shuding/nextra/pull/2811
  https://github.com/shuding/nextra/pull/2808
- 6ec3241c: Make the `<Tab />` component be crawlable and indexable by search
  engines by default

### Patch Changes

- ad108ff7: use `overflow-x-auto` instead `overflow-x-scroll` for `<Table />`
- 217f7082: update next-themes

  fix wrong numbering for nested `<Steps />`

## 3.0.0-alpha.22

### Patch Changes

- 2630461c: fix
  `TypeError: undefined is not iterable (cannot read property Symbol(Symbol.iterator))`
  on dev environment when `frontMatter.searchable: false`

## 3.0.0-alpha.21

## 3.0.0-alpha.20

## 3.0.0-alpha.19

## 3.0.0-alpha.18

### Minor Changes

- f71e660e: change to shiki again

### Patch Changes

- 98f439ca: export `evaluate` function for remote content
- 98f439ca: add rust icon

## 3.0.0-alpha.17

### Minor Changes

- 30438264: add shikiji twoslash

  Demo feature:
  https://nextra-v2-na3obnhub-shuding1.vercel.app/docs/guide/twoslash-support

### Patch Changes

- 9f55bd1f: update rehype-pretty-code/shikiji to latest

## 3.0.0-alpha.16

### Minor Changes

- 5a637010: add icons for following languages:
  - GraphQL (`graphql`)
  - C++ (`c++`, `cpp`)
  - C# (`csharp`, `c#`, `cs`)
  - Python (`python`, `py`)

  allow disallow mobile word wrap button in code blocks with `word-wrap=false`
  meta data setting

### Patch Changes

- 90c129e6: children in Card component is required only if the image prop is
  true

## 3.0.0-alpha.15

### Patch Changes

- 1a364694: add `frontMatter.sidebarTitle` only if `frontMatter.title` is empty

## 3.0.0-alpha.14

## 3.0.0-alpha.13

### Minor Changes

- 60ec68c4: improvements for remarkStaticImage:
  - import same image only once
  - support importing images by markdown image definitions

- 6070b025: rename `frontmatter.sidebar_label` to `frontmatter.sidebarTitle`
- 8bce16d3: replace `transformPageOpts` nextra option by `transformPageMap`
- 6070b025: move `removeLinks` function from `nextra-theme-docs` to
  `nextra/remove-links`

### Patch Changes

- c74ae90a: Fix TypeError: \_jsx is not a function for remote content on
  development environment

## 3.0.0-alpha.12

### Minor Changes

- 3644e1c2: add `remark-smartypants`

### Patch Changes

- 57bc0e2a: fix reload of nextra layout on route change, reported by sound.xyz

## 3.0.0-alpha.11

### Major Changes

- c2ad837d: update to MDX3

## 3.0.0-alpha.10

### Patch Changes

- 9099c354: remove `nextra/mdx-plugins`, add `nextra/remark-plugins`

## 3.0.0-alpha.9

### Patch Changes

- 8efbb45c: remove `nextra/data` export, move `useData` to `nextra/hooks`,
  `RemoteContent` to `nextra/components`
- 80e11e04: move `resolvePageMap` to `nextra/page-map-dynamic`

## 3.0.0-alpha.8

### Minor Changes

- 440ff42d: add MathJax support

## 3.0.0-alpha.7

### Patch Changes

- 0b5cc9d5: make nextra compatible with windows

## 3.0.0-alpha.6

### Patch Changes

- 03da778a: fix `*` theme settings for dynamic routes when route is not exist in
  page map

## 3.0.0-alpha.5

### Patch Changes

- a3b67aea: `_meta` should return
  `export const getStaticProps = () => ({ notFound: true })` for static exports,
  instead of page without contain

## 3.0.0-alpha.4

### Patch Changes

- 7faa0968: fix visible hidden pages on mobile which set up with
  `display: 'hidden'`

## 3.0.0-alpha.3

### Patch Changes

- fe5061b7: fix for remote docs

## 3.0.0-alpha.2

### Patch Changes

- cb247901: fix broken `export default` statement in mdx files

## 3.0.0-alpha.1

### Major Changes

- e7e8e849: show react components, variable interpolation and latex in toc
- 71882780: - insert `frontMatter` as export node via custom remark plugin
  - remove `frontMatter.mdxOptions` support

- 023d37b1: add `"type": "module"` to `nextra` package
- 148278ce: rename tailwind prefix `nx-` to `_` to reduce bundle size
- d7d8a3eb: new styles for code blocks aka in next.js
- 63ca28be: Remove support of "\_meta.json", use "\_meta.{js,jsx,ts,tsx}"
  instead.
- b9f88e34: - remove `use-internals.ts`
  - remove `layout.tsx`, move directly to `setup-page.tsx`
  - remove `kind: 'Meta' | 'Folder' | 'MdxPage'` to keep page map smaller

- 128e195f: fix React warning, remove PageOpts.toc, use `toc` prop from
  `components.wrapper`
- 1f3e7cd4: - remove `__nextraPageOptions.hot`
  - remove `__nextraPageOptions.pageOptsChecksum`
  - remove `__nextra_internal__.refreshListeners` (no longer needed since we
    insert toc as esm node in remark plugin)
  - remove `hashFnv32a`

- 198dbcca: use toc with JSX elements for remote content
- 191e6c41: - use `shikiji` instead of `shiki`
  - rename `useSSG` to `useData`

- c7f03e54: rename `pageOpts.headings` to `toc`

### Minor Changes

- c7f03e54: should not add virtual `_meta` file if missing
- a52a869e: add `frontmatter.sidebar_label` support for setting page label in
  sidebar via frontmatter
- 4e55c064: add support for `_meta.{js,jsx,ts,tsx}` with JSX support

### Patch Changes

- 1f3e7cd4: fix `pageProps` for NextraLayout

## 3.0.0-alpha.0

### Major Changes

- 50a52fd1: - ❌ remove `_app.mdx`, use `_app.{js,jsx}` or `_app.{ts,tsx}` for
  TypeScript projects instead
  - ❌ remove Nextra middleware `nextra/locales`
  - ❌ remove `parseFileName` from `nextra/utils`
  - ❌ remove `nextra/filter-route-locale`
  - ❌ remove `resolvePageMap` and `pageMapCache` from `nextra/page-map`
  - ❌ remove `__nextraPageOptions.pageNextRoute`
  - ❌ remove `pageOpts.route` and `pageOpts.newNextLinkBehavior`
  - ❌ remove `LoaderOptions.defaultLocale`
  - ❌ remove `__nextra_internal__.context[route].themeConfig`
  - ✅ add `nextra/fetch-filepaths-from-github`
  - save `pageMap` to `.next/static/chunks/nextra-page-map-{locale}.mjs`
  - save `fileMap` to `.next/static/chunks/nextra-file-map.mjs`

- 919fe977: set `"peerDependencies.next": ">=13"`
- ad4823d9: add zod validation for nextraConfig
- ab07609c: remove `locale` and `defaultLocale` from `normalizePages`
- 2f3be336: - set `"engines.node": ">=18"`
  - remove `Tab` export, use `Tabs.Tab` instead
  - remove `Card` export, use `Cards.Card` instead
  - disallow import md/mdx files that are outside the working directory, use
    symlinks instead

- 66cce1d1: **BREAKING** bundle to ESM only

  > ⚠️⚠️⚠️ use `next.config.mjs` or `next.config.js` with `"type": "module"`

- 576cb6f1: - rename `nextraConfig.flexsearch` to `nextraConfig.search`

### Minor Changes

- 0fe55db2: add `import { useRouter } from 'nextra/hooks'` for fetching `locale`
  and `defaultLocale`

### Patch Changes

- d8a406b4: add `"sideEffects": false` for better tree-shaking

## 2.13.4

## 2.13.3

### Patch Changes

- 93b57052: fix `type: 'separator'` zod validation, mark `title` field as
  optional

## 2.13.2

### Patch Changes

- ad7b31b0: downgrade remark-math from `6` to `5.1.1` to fix
  `TypeError: Cannot read properties of undefined (reading 'mathFlowInside')`
  error

  fix support of ```math lang that was overridden by `rehype-pretty-code`

## 2.13.1

### Patch Changes

- ee02a483: fix `Property 'existsSync' does not exist on type`

## 2.13.0

## 2.12.3

### Patch Changes

- ffb6d808: - Fix
  `TypeError: Cannot read properties of null (reading 'classList')` while
  navigating to route that doesn't have toc with `router.push` for example
  - Add alias `Tabs.Tab` to `Tab` component
  - Add alias `Cards.Card` to `Card` component
  - should not attach custom heading id as id attribute if parent is `Tabs.Tab`
    or `Tab`
  - should not save to toc list headings of level 1

## 2.12.2

### Patch Changes

- 7c8c4989: fix `Out of Memory` in search while indexing large words

## 2.12.1

### Patch Changes

- 52ae8fc5: - always cache md/mdx compiler for non-remote content and never
  cache for remote content
  - refactor function arguments for `compileMdx`
  - fix source code from loader was stripped starting from last match
    `export default MDXContent;` and until the end, so `transform` function was
    not applied
  - fix `headings` were `undefined` in remote content

## 2.12.0

### Minor Changes

- d9820746: - show headings for partial md/mdx in toc
  - hide headings in toc when parent `<Tab />` or `<Tabs.Tab />`

- 8962597e: - allow override static image component that was hardcoded to
  `import Image from 'next/image'` now it's plain `<img />`
  - support `<details />`/`<summary />` for `.md` files

### Patch Changes

- fbf003cd: cache md/mdx processor

## 2.11.1

### Patch Changes

- ddddce95: skip search indexing for 404/500 pages
- 6154e312: ensure first h1 is set as page title if frontmatter.title is missing
- 46743ba4: fix TS error
  `Cannot find module 'nextra/filter-route-locale' or its corresponding type declarations.`
  while importing

  ```js
  import filterRouteLocale from 'nextra/filter-route-locale'
  ```

- 4dd720ad: remove `font-weight: 500;` from styles of code blocks since it gives
  no effect

## 2.11.0

### Patch Changes

- 3bb480a4: use github-slugger for custom heading ids to prevent duplicated
  headings
- 3bb480a4: fix custom heading id in search result
- 3bb480a4: fix
  `Warning: Prop href did not match. Server: "/blog.en-US#" Client: "/blog#"` in
  by `normalizePages` from nextra/normalize-pages`
- 3bb480a4: strip `.html` extension from URL route for static export

## 2.10.0

### Minor Changes

- e54b008: - add `@theguild/remark-npm2yarn` package that replaces the code
  block that has `npm2yarn` metadata with `<Tabs />` and `<Tab />` components
  from `nextra/components`.
  - `<Tabs />` now has `selectedKey` prop, the chosen tab is saved in the local
    storage, which will be chosen in future page renders.

  More info https://nextra.site/docs/guide/advanced/npm2yarn

## 2.9.0

### Minor Changes

- 16bbb88: Move below packages to nextra package
  - `<Cards />` and `<Card />`
  - `<Tabs />` and `<Tab />`
  - `<Steps />`
  - `<FileTree />`

  to import them you can use the following in your official `nextra-theme-blog`
  and `nextra-theme-docs`

  ```js
  import { Card, Cards } from 'nextra/components'
  ```

  ```js
  import { Tab, Tabs } from 'nextra/components'
  ```

  ```js
  import { Steps } from 'nextra/components'
  ```

  ```js
  import { FileTree } from 'nextra/components'
  ```

### Patch Changes

- 23a25b1: replace last match of `export default MDXContent;`

## 2.8.0

### Patch Changes

- 6c12bf4: fix broken code format while selecting and copying code with
  `showLineNumbers` option enabled

## 2.7.1

### Patch Changes

- 0e53ca51: remarkMermaid should be before removing imports for remote markdown

## 2.7.0

### Minor Changes

- 44626e8f: support mermaid diagrams

## 2.6.2

### Patch Changes

- 9c9625ee: Fix search not working in certain Next.js versions

## 2.6.1

### Patch Changes

- 1e9ebabc: remove `remarkLinkRewriteOptions` from `buildDynamicMDX`

## 2.6.0

### Minor Changes

- 1c6256b: Move Callout component to nextra package

### Patch Changes

- 15c4092: fix inconsistent `font-weight: bold` style for `type: 'menu'`

## 2.5.2

### Patch Changes

- a3601e5: fix Module not found: Can't resolve
  '.../node_modules/nextra/dist/mdx.mjs'

## 2.5.1

### Patch Changes

- d408ab0: fix `Error: ENOENT: no such file or directory` in Nx-managed
  monorepos

## 2.5.0

### Minor Changes

- 08d393e: support ANSI highlighting

## 2.4.2

### Patch Changes

- 16e562d: fix Next.js 13.3.1 compatibility for SyntaxError: Named export
  'existsSync' not found.

## 2.4.1

### Patch Changes

- a992ce1: do not add dynamic routes to pageMap

## 2.4.0

### Minor Changes

- 0a50cad: support symlinked pages

### Patch Changes

- 545bd7c: Remove `.mdx?` of local links only
- 259bfbc: do not throw error when `output: 'export'` is specified in
  `next.config.js`

## 2.3.0

### Minor Changes

- 6ea1caf: fix crash of dev server when `_meta.js` contains errors

  disallow caching of `_meta.js` on dev env

  set minimal `node` as `16`

- 76e8b0f: support custom heading id via
  `# my very long heading... [#my-custom-heading]` syntax
  https://github.com/shuding/nextra/pull/1645

### Patch Changes

- 0dd028a: Prints the warning inline instead of the current behavior which
  includes a stack trace.

## 2.2.20

### Patch Changes

- 2e48307: export `normalizePages` from `nextra/normalize-pages`, `useFSRoute`
  from `nextra/hooks` (can be useful for custom theme)
- e4c8b6d: fix crash of dev server when \_meta.json is malformed

## 2.2.19

### Patch Changes

- e41cbbc: fix `transformPageOpts` with \_app.mdx, `pageMap` was still included
  even it was removed in `transformPageOpts`
- a1e59b2: Support Markdown links with query or anchor.

## 2.2.18

### Patch Changes

- 9bd2d59: remove the .md and .mdx extension from links
- c2287e1: fix buildDynamicMDX options passed to compileMdx
- 90cb6b8: do not auto create `_app.mdx` if missing

## 2.2.17

### Patch Changes

- 4a66366: fix TypeError: Cannot read properties of undefined (reading '/') with
  \_app.mdx while editing theme.config, \_meta.json or adding/removing md/mdx
  files

## 2.2.16

### Patch Changes

- d495e5f: introduce `_app.mdx` for better performance and smallest
  `.next/static/chunks` size

## 2.2.15

### Patch Changes

- d5aa17c: do not redirect `.txt` files in nextra's `locales` middleware
- 016828e: do not redirect .mp4 in locales middleware
- b3219c3: do not override `className` for `<Td />`, `<Th />` and `<Tr />`
  components

## 2.2.14

### Patch Changes

- bcaba9c: fix capitalizing sidebar links + tests
- a683c84: fix `*` key for `collectCatchAll`
- a404ef7: fix rewrites

## 2.2.13

### Patch Changes

- d1d873f: typed frontmatter -> `useConfig<YOUR_FRONTMATTER_TYPE>`
- 6626356: prefer `import type`
- 2234a13: fix raw `__esModule` string ☠️

## 2.2.12

### Patch Changes

- 619ae3a: fix pageMap for remote content

## 2.2.11

### Patch Changes

- 7d96698: compile mdx with `format: 'detect'` in loader
- e10bf74: add support for remote `[...catchAll]` routes

  support meta keys with `/`

  sanitize remote mdx by removing `import` statements

- e04e2ce: better types for dynamic meta
- 5fd2183: ignore `.xml` files in locales middleware
- e38e61f: use decodeURI in static-image.ts

## 2.2.10

### Patch Changes

- c97143f: fix search index output location
- 256282a: fix codeHighlight being false by default for remote contet
- 4d3c20a: fix special modules being bundled in client
- 4b2052f: fix `Module not found: Can't resolve 'nextra-theme-docs/style.css'`
  for imported markdown files that located outside of CWD
- 624d6b4: fix when sidebar show non-md folders
- 0c957db: fix capitalizing of undefined \_meta.json file/folders
- d0b9249: fix subpath import failed

## 2.2.9

### Patch Changes

- c50474e: support dynamic markdown import

## 2.2.8

### Patch Changes

- d2ed10f: remove development: false
- b943146: add transformPageOpts option for advanced use cases

## 2.2.7

### Patch Changes

- 36fd8c7: add format detection
- 64cec8f: disable code splitting and fix dev errors

## 2.2.6

### Patch Changes

- be24334: improve search index generation
- 4fc13df: fix warning of dynamic imports

## 2.2.5

### Patch Changes

- 163065c: loader refactor, type-safe `__nextra_resolvePageMap`, avoid code
  interpolation in loader.ts

## 2.2.4

### Patch Changes

- 091b77b: fix missing filename

  add filename / copy code with "codeHighlight: false"

  add unit tests for filename and copy code

- 917de49: remove `github-slugger` from docs

## 2.2.3

### Patch Changes

- 11b2870: fix copy code button position

## 2.2.2

### Patch Changes

- 3145f53: extend `plugin:react/recommended`, `plugin:react-hooks/recommended`
  and `plugin:@next/next/recommended` configs
- 1834730: fix hydration error produced by cached compiler, fix broken
  code-blocks styles while setting `nextraConfig.codeHighlight: false`
- f53b935: Allow disabling code highlighting & memory improvements

## 2.2.1

### Patch Changes

- 9bcfc1d: fix error was swallowed silently

## 2.2.0

### Minor Changes

- e4b20ca: support `transform` in nextra config

### Patch Changes

- 52a1bf3: feat: allow to use plain md syntax
- af76dbe: fix highlight substring from filename for code blocks

## 2.1.0

### Minor Changes

- e5262d0: improve hmr and internal api for layout (toc and meta files)

### Patch Changes

- a923bd5: fix `collectFiles` concurrency
- 5bdc62c: fix static images on windows
- c86508c: lint fixes for `eslint:recommended` and
  `plugin:@typescript-eslint/recommended` configs
- d6c871a: simplify the custom theme layout api
- 1ff43c1: use OKLCH colors where possible
- a31678a: improve copy

## 2.0.3

### Patch Changes

- adb2d25: fix remote mdx
- 8060ed3: style improvements

## 2.0.2

### Patch Changes

- 1e2afcf: Add LaTeX support
- 99ec64e: fix indentation for copy code button
- 3a08fe2: Add Callout border in dark mode
- f488e2e: remove @react/skip-nev #1051

  fix: staticImage should only set blur placeholder for jpeg,png,webp,avif

- cf9b886: better performance of `collectFiles`
- f35e724: update shiki to v0.12.1
- b2fc168: support `nextConfig.distDir`
- cc1cb5f: support `nextConfig.basePath` with i18n

## 2.0.1

### Patch Changes

- a9748aa: fix: A11y improvements to the docs theme
- ac82b1f: make code-blocks buttons focusable if they are visible on page

## 2.0.0

### Major Changes

- 793eedb: chore: Fix CI

### Patch Changes

- e4cfb83: `addPage` no longer need accept `frontMatter`
- 94ef0b3: improve 2.0 docs
- 8101efe: fix(nextra): use `rehype-mdx-title` to determine page title
- 6644bd5: pass unstable_flexsearch
- cef5546: allow headings contain links
- 2217f9c: fix `Warning: Prop `href` did not match. Server: "#" Client: ...`
- e6771ca: fix edit on github button for cases when filename named as `index`
- 2217f9c: fix `next export` command
- fdb2f57: update docs to use next.js 13
- 803553c: use `findPagesDir` from `next/dist/lib/find-pages-dir`
- 568282e: fix broken build `SyntaxError: Unexpected token '}'`
- a0398e0: fix: avoid mutating nextConfig
- e6771ca: fix `ReferenceError` when trying to access `__nextra_pageOpts__`
  inside MDX file
- 59e18b0: make `nextra`/`nextra-theme-docs`/`nextra-theme-blog` be compatible
  with next 13
- 488f737: fix client console error - Text content does not match
  server-rendered HTML
- fc8cca0: add `<InformationCircleIcon />` icon, improve `<Callout />` default
  emojis
- fe2b714: upgrade to react 18
- 02bc6fc: use `next/future/image` if next>=12.3.0
- e4cfb83: define page title in sidebar from `frontMatter.title` if page is not
  specified in `_meta.json`
- 1ee3c92: reuse table styles from docs in blog
- f569d90: missing `nx-` class prefixes in blog fix callout padding in docs
- b1d7361: improve docs for 2.0
- 8dab966: fix invisible copy button in code blocks
- 6f987e9: fix: print shallow warning only once
- 4825365: add `@types/github-slugger` instead of manually declaring type
- f7856a1: change default options for `compileMdx`, set `jsx: false` and
  `outputFormat: 'function-body'` by default
- cc1379c: fix `Hydration failed because the initial UI...` while modifying
  `meta.json` on dev env and react 18
- 66712f0: polish docs
- e6771ca: [Blog/Docs] Add copy to clipboard button for code-blocks. Add
  `NextraConfig.unstable_defaultShowCopyCode` option to show button by default,
  add `copy` and `copy=false` options for code-blocks
- 96ed5c2: [nextra/nextra-theme-docs]: support both
  `experimental.newNextLinkBehavior` - `true` and `false`
- b365bb0: fix TypeError: Cannot read properties of undefined (reading 'data')
- 580c433: add nx- to all tailwind classes for style isolation
- c3e6227: add `overflow-x-scroll` for tables
- 1c3fedb: add missing `nx-` prefixes to table/th/tr elements
- d7e7f5b: do not add `placeholder="blur"` on `.svg` static images
- 78f1519: chore: Add strict-peer-dependencies=false
- 97e6141: fix(nextra/docs): fallback search to `en-US` instead `default`
- a0e5847: Rename some docs theme configurations
- 74a3398: update docs for 2.0
- 93d028b: use `title` package in nextra to determine sidebar title based on
  pagename
- bd2cefa: Fix css classes with `eslint-plugin-tailwindcss`
- ff8967c: add `Toggle Word Wrap` button for code-blocks (only for mobile)
- 009bf6a: Fix release workflow.
- e6771ca: rename `meta.json` to `_meta.json`
- ff8967c: fix missing `Copy Code` button in code-blocks without language
- 4a7cc10: feat(nextra): allow define custom languages for shiki with
  `mdxOptions.rehypePrettyCodeOptions` option
- a2bc427: compile `context.ts`, `ssg.ts` and `locales.ts` to esm
- 64ae4b5: add `nextraConfig.unstable_readingTime` option for blog theme
- a9523c9: fix nextra on webcontainers
- 383b869: Add Changesets and setup pre-release and release CI.
- 6dc4dee: fix `Unhandled Runtime Error: No content found for <route>`
- d7f2bbc: adjust docs theme; rename options
- 256154a: use "next/future/image" if
  `"experimental.images.allowFutureImage": true` is set in next config
- a9414be: always use `next/image`, since in next 12.3.2 `next/future/image` was
  renamed to `next/image`
- 512953f: chore: remove redundant check for
  `MARKDOWN_EXTENSION_REGEX.test(filename)` in loader
- c8605d6: feat: New layout implementation
- e6771ca: better loader types, add `MetaJsonFile`, `MdxFile`, `Folder` types
- 4157b71: set lower build target and share code highlight theme through nextra
- a1c1e4e: Update docs
- 1942a2e: chore: Fix build script
- 699d131: feat(nextra/docs/blog): allow import `.md`/`.mdx` as well
- 044721d: chore: Update turbo filters
- 256154a: replace images with `<NextImage />` even when url not relative but
  that starts from `/` (public directory)
- c751458: fix(nextra): ignore in loader files from `pages/api` folder
- e573175: Fix release CI
- 21009c7: better focus ui, use ring color as theme hue color
- 0f4795f: chore(nextra/blog/docs): provide types for PageOpts in loader
- 71528f1: show copy code button only on hover of container
- 03e90d8: refresh build system with tsup and fix nextra type
- e6771ca: rename `PageOpts.meta` to `PageOpts.frontMatter`
- 37b4445: fix react-dom peer dependency version
- 094fdec: sort `defaultMeta` by `frontMatter.date`, if missing by
  `frontMatter.title` and after by capitalized page name
- e6771ca: move `withLayout` logic directly in nextra loader
- efd95ec: fix(nextra): allow to contain dots in page filenames
- 094fdec: capitalize sidebar's folders names if item is missing in `_meta.json`
- e35bbf7: chore: rename `module` to `mod` to avoid confusing with global
  `module` object

## 2.0.0-beta.45

### Patch Changes

- 66712f0: polish docs

## 2.0.0-beta.44

### Patch Changes

- 94ef0b3: improve 2.0 docs
- fdb2f57: update docs to use next.js 13
- b1d7361: improve docs for 2.0
- 74a3398: update docs for 2.0
- d7f2bbc: adjust docs theme; rename options
- a1c1e4e: Update docs

## 2.0.0-beta.43

### Patch Changes

- 59e18b0: make `nextra`/`nextra-theme-docs`/`nextra-theme-blog` be compatible
  with next 13

## 2.0.0-beta.42

## 2.0.0-beta.41

### Patch Changes

- bd2cefa: Fix css classes with `eslint-plugin-tailwindcss`

## 2.0.0-beta.40

### Patch Changes

- f569d90: missing `nx-` class prefixes in blog fix callout padding in docs

## 2.0.0-beta.39

### Patch Changes

- a9414be: always use `next/image`, since in next 12.3.2 `next/future/image` was
  renamed to `next/image`

## 2.0.0-beta.38

## 2.0.0-beta.37

## 2.0.0-beta.36

### Patch Changes

- 1c3fedb: add missing `nx-` prefixes to table/th/tr elements

## 2.0.0-beta.35

## 2.0.0-beta.34

## 2.0.0-beta.33

### Patch Changes

- 580c433: add nx- to all tailwind classes for style isolation
- 094fdec: sort `defaultMeta` by `frontMatter.date`, if missing by
  `frontMatter.title` and after by capitalized page name
- 094fdec: capitalize sidebar's folders names if item is missing in `_meta.json`

## 2.0.0-beta.32

### Patch Changes

- fc8cca0: add `<InformationCircleIcon />` icon, improve `<Callout />` default
  emojis

## 2.0.0-beta.31

### Patch Changes

- cef5546: allow headings contain links

## 2.0.0-beta.30

### Patch Changes

- 02bc6fc: use `next/future/image` if next>=12.3.0
- f7856a1: change default options for `compileMdx`, set `jsx: false` and
  `outputFormat: 'function-body'` by default

## 2.0.0-beta.29

## 2.0.0-beta.28

## 2.0.0-beta.27

### Patch Changes

- d7e7f5b: do not add `placeholder="blur"` on `.svg` static images
- a9523c9: fix nextra on webcontainers
- 21009c7: better focus ui, use ring color as theme hue color

## 2.0.0-beta.26

### Patch Changes

- b365bb0: fix TypeError: Cannot read properties of undefined (reading 'data')
- a0e5847: Rename some docs theme configurations

## 2.0.0-beta.25

### Patch Changes

- e4cfb83: `addPage` no longer need accept `frontMatter`
- e4cfb83: define page title in sidebar from `frontMatter.title` if page is not
  specified in `_meta.json`
- c3e6227: add `overflow-x-scroll` for tables
- 93d028b: use `title` package in nextra to determine sidebar title based on
  pagename
- ff8967c: add `Toggle Word Wrap` button for code-blocks (only for mobile)
- ff8967c: fix missing `Copy Code` button in code-blocks without language
- 256154a: use "next/future/image" if
  `"experimental.images.allowFutureImage": true` is set in next config
- 256154a: replace images with `<NextImage />` even when url not relative but
  that starts from `/` (public directory)

## 2.0.0-beta.24

### Patch Changes

- a2bc427: compile `context.ts`, `ssg.ts` and `locales.ts` to esm

## 2.0.0-beta.23

## 2.0.0-beta.22

### Patch Changes

- 8dab966: fix invisible copy button in code blocks

## 2.0.0-beta.21

### Patch Changes

- 568282e: fix broken build `SyntaxError: Unexpected token '}'`

## 2.0.0-beta.20

### Patch Changes

- e6771ca: fix edit on github button for cases when filename named as `index`
- e6771ca: fix `ReferenceError` when trying to access `__nextra_pageOpts__`
  inside MDX file
- 1ee3c92: reuse table styles from docs in blog
- e6771ca: [Blog/Docs] Add copy to clipboard button for code-blocks. Add
  `NextraConfig.unstable_defaultShowCopyCode` option to show button by default,
  add `copy` and `copy=false` options for code-blocks
- e6771ca: rename `meta.json` to `_meta.json`
- 64ae4b5: add `nextraConfig.unstable_readingTime` option for blog theme
- e6771ca: better loader types, add `MetaJsonFile`, `MdxFile`, `Folder` types
- 71528f1: show copy code button only on hover of container
- e6771ca: rename `PageOpts.meta` to `PageOpts.frontMatter`
- e6771ca: move `withLayout` logic directly in nextra loader

## 2.0.0-beta.19

### Patch Changes

- 37b4445: fix react-dom peer dependency version

## 2.0.0-beta.18

### Patch Changes

- 803553c: use `findPagesDir` from `next/dist/lib/find-pages-dir`

## 2.0.0-beta.17

### Patch Changes

- 2217f9c: fix `Warning: Prop`href`did not match. Server: "#" Client: ...`
- 2217f9c: fix `next export` command
- 6dc4dee: fix `Unhandled Runtime Error: No content found for <route>`

## 2.0.0-beta.16

### Patch Changes

- 4825365: add `@types/github-slugger` instead of manually declaring type

## 2.0.0-beta.15

## 2.0.0-beta.14

### Patch Changes

- 96ed5c2: [nextra/nextra-theme-docs]: support both
  `experimental.newNextLinkBehavior` - `true` and `false`
- c8605d6: feat: New layout implementation

## 2.0.0-beta.13

### Patch Changes

- 4157b71: set lower build target and share code highlight theme through nextra

## 2.0.0-beta.12

### Patch Changes

- cc1379c: fix `Hydration failed because the initial UI...` while modifying
  `meta.json` on dev env and react 18
- 512953f: chore: remove redundant check for
  `MARKDOWN_EXTENSION_REGEX.test(filename)` in loader
- 0f4795f: chore(nextra/blog/docs): provide types for PageOpts in loader

## 2.0.0-beta.11

### Patch Changes

- a0398e0: fix: avoid mutating nextConfig
- fe2b714: upgrade to react 18
- 78f1519: chore: Add strict-peer-dependencies=false
- 1942a2e: chore: Fix build script
- 044721d: chore: Update turbo filters

## 2.0.0-beta.10

### Patch Changes

- 8101efe: fix(nextra): use `rehype-mdx-title` to determine page title
- 6f987e9: fix: print shallow warning only once
- 97e6141: fix(nextra/docs): fallback search to `en-US` instead `default`
- 699d131: feat(nextra/docs/blog): allow import `.md`/`.mdx` as well
- 03e90d8: refresh build system with tsup and fix nextra type

## 2.0.0-beta.9

### Major Changes

- 793eedb: chore: Fix CI

### Patch Changes

- 6644bd5: pass unstable_flexsearch
- 488f737: fix client console error - Text content does not match
  server-rendered HTML
- 4a7cc10: feat(nextra): allow define custom languages for shiki with
  `mdxOptions.rehypePrettyCodeOptions` option
- c751458: fix(nextra): ignore in loader files from `pages/api` folder
- e573175: Fix release CI
- efd95ec: fix(nextra): allow to contain dots in page filenames
- e35bbf7: chore: rename `module` to `mod` to avoid confusing with global
  `module` object

## 2.0.0-beta.8

### Patch Changes

- 009bf6a: Fix release workflow.

## 2.0.0-beta.7

### Patch Changes

- 383b869: Add Changesets and setup pre-release and release CI.