Markdown is the only content format that matters
Every CMS invented their own rich text format. WordPress has Gutenberg blocks. Contentful has their rich text JSON. Sanity has Portable Text. They all solve the same problem — storing formatted text — and they all invented a proprietary way to do it.
Markdown already solved this.
Why Markdown wins
- Portable — move content between tools without conversion
- Version-controllable — diff-able, merge-able, human-readable
- Future-proof — been around since 2004, will be around in 2040
- Developer-friendly — every developer already knows it
The lock-in trap
When you store content in a proprietary format, you're locked in. Want to switch CMS providers? Good luck migrating thousands of rich text JSON documents. Want to use the content outside the CMS? Hope you like writing converters.
Markdown content is just text. It works everywhere. It will always work.
PageKit's approach
PageKit stores content as Markdown. Not as an afterthought — as the primary format. The editor writes Markdown. The API returns Markdown. The SDK gives you Markdown. Your content is yours.