mdx-js/mdx

README

Markdown for the component era


Build

MDX is an authorable format that lets you seamlessly write JSX in your markdown documents. You can import components, such as interactive charts or alerts, and embed them within your content. This makes writing long-form content with components a blast. 🚀

  1. ``` gfm
  2. import {Chart} from './snowfall.js'
  3. export const year = 2018

  4. # Last years snowfall

  5. In {year}, the snowfall was above average.
  6. It was followed by a warm spring which caused
  7. flood conditions in many of the nearby rivers.

  8. <Chart year={year} color="#fcb32c" />
  9. ```

See § What is MDX for more info on the format. See § Playground to try it out.

What is this?


This GitHub repository contains several packages for compiling the MDX format to JavaScript, integrating with bundlers such as webpack and Rollup, and for using it with frameworks such as React, Preact, and Vue.

See § Getting started for how to integrate MDX into your project.

Security


See § Security on our site for information.

Contribute


See § Contribute on our site for ways to get started. See § Support for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

Sponsor


See § Sponsor on our site for how to help financially.

|   |   |   |   |   |
| :--- | :--- | :--- | :--- | :--- |
|    Vercel   |    Motif   |    HashiCorp   |    GitBook   |    Gatsby    |
|
|    Netlify      |    Coinbase   |    ThemeIsle   |    Expo   |    Boost Note   |    Holloway   | | |  |
|       You?    |

License


MIT © Compositor and Vercel