Processing Markdown File Extensions with Gatsby MDX

Chris Biscardi
InstructorChris Biscardi
Share this video with your friends

Social Share Links

Send Tweet
Published 5 years ago
Updated 3 years ago

Some platforms support .md file extensions better than they support .mdx. For this reason (or others) it can be useful to apply MDX processing to files with .md extensions as well as .mdx extensions.

Instructor: [00:00] Here we have a running Gatsby site, an mdx file and the result of that mdx file. Note that our Gatsby site is configured with Gatsby MDX because we haven't passed in any options like we have for other plugins.

[00:11] It's using the default config. The default configuration for Gatsby MDX only applies to files with .mdx in the file name.

[00:20] Note that moving the pageThree.mdx file to results in a page that doesn't exist because Gatsby MDX has not set up to process .md files.

[00:33] To enable Gatsby MDX to process .md files, as well as .mdx files, we'll use the extensions option in Gatsby MDX's config. Note that any time you change the Gatsby config.js file, you must restart the Gatsby process.

[00:48] Now when we refresh the page, we can see that is now considered an MDX file.

~ an hour ago

Member comments are a way for members to communicate, interact, and ask questions about a lesson.

The instructor or someone from the community might respond to your question Here are a few basic guidelines to commenting on

Be on-Topic

Comments are for discussing a lesson. If you're having a general issue with the website functionality, please contact us at

Avoid meta-discussion

  • This was great!
  • This was horrible!
  • I didn't like this because it didn't match my skill level.
  • +1 It will likely be deleted as spam.

Code Problems?

Should be accompanied by code! Codesandbox or Stackblitz provide a way to share code and discuss it in context

Details and Context

Vague question? Vague answer. Any details and context you can provide will lure more interesting answers!

Markdown supported.
Become a member to join the discussionEnroll Today