Skip to content
@MarkdownMadness

Markdown Madness

This is a demo org created by Gilbert Sanchez to show different types of static sites you can create.

Markdown Madness: Static Sites for Fun & Profit

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.


Repos in this Org

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

What This Talk Covers

  • 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 Toolsmarkdownlint, Vale, alex
  • Running Locally with Docker — each generator has a Dockerfile so you don't need the runtime installed
  • Deploying — GitHub Pages, Netlify, Cloudflare Pages, Vercel, and more

The Same Content, Everywhere

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.


Resources from the Talk


About the Speaker

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. ☕

Popular repositories Loading

  1. .github .github Public

    The org repo where we put in our readme and special stuff.

Repositories

Showing 1 of 1 repositories

Top languages

Loading…

Most used topics

Loading…