---
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](https://flowershow.app) 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)](https://github.com/flowershow/wayofmarkdown/issues/46) for what's done and what's next, and the [inbox issue (#45)](https://github.com/flowershow/wayofmarkdown/issues/45) for loose ideas. Plans and the work log live in [docs/plans/](docs/plans/); vision and approach notes are in [docs/vision.md](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.
查看 README 源文件