< Back to archive

Jamstacked Issue 50

Jamstack has a Markdown problem

Published: Mar 3, 2022

Your update on all things Jamstack

#​50 — March 3, 2022
✦ web version

Jamstack has a Markdown problem. This isn't new – I was talking about it back in 2015 whenever I'd present on static site generators (SSGs). However, Knut Melvær's recent post really brought the issue back into the forefront for me.

Developers love Markdown because we think it is easy...and it is, if you are writing simple content. Once you get outside the handful of tags Markdown supports, it gets more complex. We've solved that by adding flavors or even MDX, but then we've added the complexity back in. All of this can make it a problematic solution for writers, who have to learn Markdown syntax and then HTML or, heaven forbid, JSX, for where Markdown doesn't suffice.

What's the solution? Knut has his thoughts. I'm still undecided.

Brian Rinaldi

↘︎ What's good

Thoughts On Markdown
A thought proviking article. Markdown has become so synonymous with Jamstack that many people confuse the M in the JAM acronym for Markdown. However, I agree with Knut that it’s also been problematic in many ways for quite some time, though whether new structured content formats solve the problem remains to be seen.

Knut Melvær

The ‘Rebirth’ Era
The latest edition of this ongoing series looks at some newer reincarnations of older SSGs like Bridgetown for Jekyll and VitePress for VuePress. The prior edition looked at tools like RedwoodJS and others that tried to bring Rails-like convention-over-configuration to Jamstack.

Mike Neumegen

Another Early Look - Netlify Graph
Netlify recently released Netlify Graph, which makes it easy to integrate with a list of predefined APIs. In this post, Ray takes it for a spin and shows how to integrate it with Eleventy.

Raymond Camden

Misconceptions About Databases in The Jamstack
The idea that a Jamstack site can’t be database driven is definitely a misconception, but, as this article points out, there are also a number of things you need to think about when connecting a Jamstack site to a database.

Taylor Barnett

✂︎ Tools and Resources

  • Gatsby v4.9 – The primary highlight of this release is support for TypeScript in gatsby-config and gatsby-node.
  • Image CDN for Gatsby Cloud – Gatsby announced new CDN level image processing for Gatsby Cloud during GatsbyConf.
  • Local Development in Stackbit – Stackbit added support for local development that synchronizes with the content editor via their CLI.
  • Adding Search to a Jamstack Site – A free chapter excerpt from The Jamstack Book by Ray Camden and I.
  • TheJam.dev Session Playlist – All 18 sessions from TheJam.dev in January are now posted to YouTube. Check out ones you missed or rewatch your faves.
  • TinaCMS in 2022 – There are some big plans for TinaCMS coming soon, including a 1.0 release and support for more frameworks.

❖ Tidbits

Minimum Static Site Setup with Sass
Most SSGs include processing Sass as part of the build process, but if you needed to set that up manually, this should help.

Stephanie Eckles

An Open Source Ecommerce Platform for Nuxt.js
A walkthrough of building a Jamstack ecommerce site using Medusa, an open source headless ecommerce solution, and Nuxt.

Carlos Padilla

Announcing Changes to Netlify Plans
Netlify has made some adjustments to their pricing structure. It appears that this will primarily impact Pro and Business plan customers and will impact deploy permissions and maximum members. However, the plans now include more bandwidth and more build minutes.


Thank you for reading. — Brian