diff --git a/docs/writing-docs/mdx.md b/docs/writing-docs/mdx.md index 093a6c78cbc1..1c71ca5b759e 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.