Getting Started

There are two ways to get started with Gatsby+MDX. You can add support to an existing site or you can use an MDX based starter.

Add to Existing Gatsby Site

To use gatsby-mdx with a pre-existing gatsby site install gatsby-mdx as well as MDX itself which comes in two packages (@mdx-js/mdx and @mdx-js/tag)

npm install gatsby-mdx @mdx-js/mdx@0.15.x @mdx-js/tag@0.15.x

then add gatsby-mdx to your gatsby-config.js in the plugins section.

module.exports = {
plugins: [`gatsby-mdx`]

Note: gatsby-mdx is only compatible with Gatsby version 2 or newer.

Use a Starter

TODO: write the starter and this section