Markdown quietly won. Google Docs speaks it, WhatsApp speaks it, Slack and Discord speak it, every AI chat speaks it — and almost nobody notices, because markdown itself was never really the point. What you can build on top of it is.
We've been contributing to The Way of Markdown, a free site that makes the case for working this way: keep your content as plain files you actually own, then build whatever you need on top of them — a website, a knowledge base, a wiki, even something Notion-shaped — using tools you can swap out whenever you want. No renting a platform, no lock-in.
A few things worth knowing about it.
It's a real guide library, not just a manifesto with nothing behind it. There are 25 guides so far — eleven cover markdown in specific apps like WhatsApp, Slack, Discord, Notion, ChatGPT, Google Docs, Obsidian, GitHub, Reddit and Telegram (Apple Notes gets one too, as the last real holdout), and the other fourteen walk through what to actually build: websites, wikis, docs, databases, blogs, digital gardens, a proper way out of Notion, and more.
It also practices what it teaches. The whole site is just markdown files sitting in a public GitHub repo, published with Flowershow — every single page has an "edit this page" link that goes straight back to the source. Full disclosure since it matters: Flowershow is our tool, so of course it gets recommended. But every guide names the real alternatives too — Hugo, Jekyll, Astro, MkDocs, Docusaurus — because the whole point of working this way is that the tools stay swappable. Ours included.
The part we think doesn't get enough credit: markdown has basically become the default language AI reads and writes. That's not a stylistic choice on their part — it's just what they were trained on. If your notes live in plain markdown, an AI agent can read them, edit them, reorganize them directly. If they're stuck inside a proprietary format, there's an export button standing in the way first.
If you're in the middle of getting out of Notion, or you're just tired of your notes app fighting your AI tools instead of working with them, it's worth a look: wayofmarkdown.com
Top comments (0)