PowerShell + DevOps Summit 2026 — presented by Gilbert Sanchez (@HeyItsGilbert)
You already write Markdown. README.md, meeting notes, maybe even your grocery list.
But what if that Markdown could become a blog, a polished docs site, a personal resume, or even a link-in-bio page?
This organization hosts all the demo sites and code from the Markdown Madness talk — one repo per static site generator, all built from the same Markdown content.
| Generator | Language | Best For | Repo |
|---|---|---|---|
| Jekyll | Ruby | Blogs, GitHub Pages | jekyll-demo |
| MkDocs | Python | Project documentation | mkdocs-demo |
| Hugo | Go | Blazing-fast anything | hugo-demo |
| Docusaurus | React/MDX | Versioned docs | docusaurus-demo |
- Markup vs. Markdown — what flavors exist (GFM, CommonMark, MDX) and when they matter
- Static Site Generators 101 — CLI-generated, output as HTML, no runtime server required
- Generator Deep Dives — Jekyll, MkDocs, Hugo, and Docusaurus side-by-side
- VS Code Tooling — GitHub Markdown Preview, markdownlint, Reflow Markdown, Markdown All in One, Marp, FrontMatter CMS
- Prose & Quality Tools —
markdownlint, Vale, alex - Running Locally with Docker — each generator has a
Dockerfileso you don't need the runtime installed - Deploying — GitHub Pages, Netlify, Cloudflare Pages, Vercel, and more
All demo sites render the same source Markdown:
- Getting Started — quick intro guide
- Showcase — feature highlights
- Blog — a sample post (Morning Coffee)
This makes it easy to compare how each generator handles identical content.
- Jekyll Docs
- MkDocs Material Theme
- Hugo Docs
- Docusaurus Docs
- Marp — Markdown Presentation Ecosystem
- FrontMatter CMS VS Code Extension
- Vale — Prose Linting
- alex — Catch Insensitive Writing
Gilbert Sanchez is a Staff Software Development Engineer who turns infrastructure into PowerShell and Markdown into websites.
Find him at @HeyItsGilbert or anywhere there's a good cup of coffee. ☕