Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


Parses Markdown files using Remark.


npm install --save gatsby-transformer-remark

How to use

// In your gatsby-config.js
plugins: [

Parsing algorithm

It recongnizes files with the following extensions as Markdown.

  • md
  • rmd
  • mkd
  • mkdn
  • mdwn
  • mdown
  • litcoffee
  • markdown

Each Markdown file is parsed into a node of type MarkdownRemark.

All frontmatter fields are converted into GraphQL fields. TODO link to docs on auto-inferring types/fields.

This plugin adds additional fields to the MarkdownRemark GraphQL type including html, excerpt, headers, etc. Other Gatsby plugins can also add additional fields.

How to query

A sample GraphQL query to get MarkdownRemark nodes:

  allMarkdownRemark {
    edges {
      node {
        frontmatter {
          # Assumes you're using title in your frontmatter.
© 2023 Gatsby, Inc.