Velho Docs

Documentation for how I publish documentation for my projects - the tooling decision, the build pipeline, and how these sites are hosted on Cloudflare.

What this is

A live test project. It is built from plain Markdown with MkDocs + Material, deployed to Cloudflare, and deliberately built so Zensical can also serve it later.

Start here

• The decision - MkDocs + Material now, Zensical later, and why.
• Tool comparison - the two toolchains side by side.
• Publishing to Cloudflare - how the build gets online.

Why "boring" Markdown wins

TodayTomorrow

docs/*.md  +  mkdocs.yml   ->   mkdocs build   ->   site/   ->   Cloudflare

docs/*.md  +  mkdocs.yml   ->   zensical build   ->   site/   ->   Cloudflare

Same sources, either builder. That is what makes the setup future-proof.