@storybook/addon-docs Unable to parse *.stories.mdx file

[yuyu668668]

Summary

when the mdx file name is *.stories.mdx，the webpack will parsing error. When I change the files name to *.mdx or *.abc.mdx, it resolves correctly.

Additional information

No response

Create a reproduction

No response

[dosubot[bot]]

The .stories.mdx format was removed in Storybook 8.0 [1]. In modern Storybook, you need to separate your MDX content into two files:

• .stories.ts/.tsx — defines your component stories (CSF format)
• .mdx — contains your documentation, referencing those stories

An automatic migration codemod is available [2]:

npx storybook@latest migrate mdx-to-csf --glob "src/**/*.stories.mdx"

This will split each .stories.mdx file into a CSF story file and a plain .mdx doc file. After running it, make sure your .storybook/main.ts stories glob includes both patterns:

stories: [
  '../src/**/*.mdx',
  '../src/**/*.stories.@(js|jsx|ts|tsx)',
],

Could you share which version of Storybook you're using? If you're on a version older than 9.x, please upgrade to the latest 9.x and retest — along with running the migration codemod above. A minimal reproduction repo would also help if the issue persists after migrating.

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.