publish	false

The Way of Markdown

Source for The Way of Markdown, a site about markdown and the markdown-based way of working: how to use markdown and its tool ecosystem (Obsidian, GitHub, Flowershow, …) to build websites, docs, knowledge bases and more, and why an open, plain-text, no-lock-in approach wins.

Published with Flowershow at https://wayofmarkdown.com. The site content is the markdown in this repository.

Structure

• index.md — landing page
• why.md — the case for the markdown-based approach
• manifesto.md — The Markdown Manifesto
• basics.md — markdown syntax primer
• learn/ — tutorial series: build a website with Markdown + Obsidian + GitHub + Flowershow
• kb/ — knowledge base: notes on markdown in apps, tools, and workflows
• markdown-database.md — essay: the Markdown Database Pattern
• docs/ — internal/dev docs (vision, naming, plans, work log) — not published
• config.json — Flowershow site configuration

Contributing / working on the site

Work is tracked in GitHub issues: see the current epic (#46) for what's done and what's next, and the inbox issue (#45) for loose ideas. Plans and the work log live in docs/plans/; vision and approach notes are in docs/vision.md.

Edit content as plain markdown (Obsidian works great — this repo is a valid vault). Changes pushed to main deploy automatically via Flowershow.