Explore everything on this site
The full contents of The Way of Markdown, grouped: getting started, tutorials, build guides, markdown in your apps, comparisons, reference and background.
Explore everything 🗺️
Everything on the site, grouped. If you'd rather be walked through it in order, the roadmap does that instead.
Start here
- Markdown Basics — the whole syntax, ten minutes
- Playground 🎮 — type markdown, watch it render
- The Roadmap — the visual map, zero to building anything
- Publish a markdown file online — the smallest possible version of all this
- Team onboarding — the sequenced path, with checkpoints
Tutorials and how-tos
The tutorial series takes you from an empty folder to a published website using Markdown + Obsidian + GitHub + Flowershow.
- Background and motivation — what markdown is, and why this stack
- Tutorial 1: create a website from scratch
- Tutorial 2: edit a website locally
- Tutorial 3: collaborating with others
- Tutorial 4 — work in progress, outline form
Earlier versions of the first two tutorials are also still online, and cover the same ground: tutorial 1, tutorial 2.
How-tos, for when you want one specific thing:
- Add a simple page · edit text on a page · edit or add pages locally
- Add images to a page
- Quickly create a sandbox website
- Publish an Obsidian vault to GitHub
- Create a simple catalog of anything
Build something
The guides. Each one follows the same shape: what the thing is, the markdown-based pattern behind it, the tools, then a walkthrough. Index: markdown-based everything.
- Websites — the complete guide
- Blogs
- Knowledge bases and second brains
- Wikis and team handbooks
- Digital gardens
- Databases and catalogs
- Documentation sites
- Journals and daily notes
- Books and long-form writing
- Bookmarking and web clipping
- Landing pages
Going deeper:
- The Markdown Database Pattern — your filesystem is already a database
- Pluggable markdown — the plugin system hiding in three backticks
Markdown in your apps
Which apps speak markdown, how well, and where the quirks are. Hub with the full compatibility table: Markdown is Everywhere 🌍.
- Obsidian · GitHub · ChatGPT, Claude and friends
- Google Docs · Notion · Apple Notes
- WhatsApp · Slack · Discord · Telegram · Reddit
Comparisons and escapes
- Notion vs Markdown — can a folder of files replace it?
- Replace Notion with markdown — the escape guide
Reference and tools
The reference shelf: things to look up rather than read through.
- Git and GitHub glossary for non-developers — every term in plain language
- Git rescue 🚑 — undo, unstage, merge conflicts
- GitHub tips and FAQs
- Heading identifiers — the
{#custom-id}syntax and where it works - into.md · Turndown · Markdoc — converters and frameworks
- Using AI to edit notes in Obsidian · Using Cursor with Obsidian
Why, and where this came from
- The Markdown Manifesto — the short, loud version of what we believe
- Why markdown-based — the same case, argued properly
- The Markdown Timeline — a brief history
- The Markdown Canon 📜 — the essential texts, from Gruber's spec onwards
- Videos 🎬 · Badges ❤ · About this site
From the changelog:
