diff --git a/docs/writing-docs/mdx.md b/docs/writing-docs/mdx.md index 95170975e4e0..6b54882eb69b 100644 --- a/docs/writing-docs/mdx.md +++ b/docs/writing-docs/mdx.md @@ -2,6 +2,8 @@ title: 'MDX' --- + + [MDX](https://mdxjs.com/) files mix Markdown and Javascript/JSX to create rich interactive documentation. You can use Markdown’s readable syntax (such as `# heading`) for your documentation, include stories defined in [Component Story Format (CSF)](../api/csf.md), and freely embed JSX component blocks at any point in the file. All at once. In addition, you can write pure documentation pages in MDX and add them to Storybook alongside your stories.