Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


A Gatsby plugin for turning markdown files into templated pages.


With Yarn:

yarn add gatsby-plugin-markdown-pages

Or with npm:

npm install --save gatsby-plugin-markdown-pages


In your gatsby-config.js:

plugins: [

Example markdown page in ./src/pages/about-us.md:

title: About Us
template: some-template

About us copy...

This would create a page at /about-us/ and use the ./src/templates/some-template.js file as a template.

You can also supply a default template in case you don’t want to specify in your markdown files as well as new default markdown and template paths:

plugins: [
      resolve: 'gatsby-plugin-markdown-pages',
      options: {
         path: './src/pages', // Path to markdown files to be converted to pages
         templatePath: './src/templates', // Path to page templates
         template: 'default', // Default template to use if none is supplied
© 2023 Gatsby, Inc.