A website made of .mdz files

Every page on this site is one MDZip (.mdz) file: a Markdown document and its pictures, packaged together in a single file. You write a page in an editor that opens .mdz, save it into the repository, and push. GitHub turns each .mdz into a web page and publishes the site.

There’s no build code in the repository: no static site generator, no build script, no node_modules. Just the pages, a page template and a style sheet.

• How it works shows the path from your editor to the web.
• What a page can show: headings, lists, tables, pictures, diagrams, code and math.
• Add a page walks through adding one.

Why .mdz pages?

A Markdown page with pictures is usually a .md file plus a folder of images, kept in step by hand. Rename the folder, copy the page somewhere else, or email it, and the pictures break.

An .mdz keeps them together. The page you see in your editor is the page that gets published, pictures included, and it’s still a page you can send to someone or open in another app.

Make your own

This repository is meant to be copied. Click Use this template on GitHub, turn on GitHub Pages, and replace the pages with yours. Add a page has the details.