Markdown referencing markdown with Gatsby

Written in 2022, 4 years ago. Tools and advice may have moved on since.

In yesterday’s unauthorized and rum-fueled treasure hunts in the sharky waters around the Gatsby islands helping Mirjam we looked at how to use markdown for marketing pages.

One of the tricks we covered is to reference a markdown file from the front matter of another markdown file.

---
sections:
  - title: About us
    md: ../about.md
---

It gives you access to the fully transformed markdown node through childMarkdownRemark.

query ExampleQuery {
  markdownRemark{
    frontmatter {
      sections {
        title
        md {
          childMarkdownRemark {
            html
          }
        }
      }
    }
  }
}

Kinda neat, right?

 
All the best,
Queen Raae

 
PS: I am a markdown aficionado, how about you? Would you like more markdown tips and tricks?