Markdown-pages is a Static Site Generator for Markdown powered by Gradle, Pandoc, Spock, Preact and a minimalistic template. For Debian with Java 18 or newer.

Get markdown-pages

curl -L https://raw.githubusercontent.com/marcbperez/markdown-pages/0.12.0/install.sh | sh

Installs the latest version in ~/.local/bin. To change the default folder set the first parameter. For example, .../install.sh | sh -s -- . uses the current directory.

Create a site

markdown-pages makes sites out of Markdown documents and shows them at http://localhost:8000.

mkdir my-website
cd my-website
echo "# Home" > index.md
markdown-pages

Next steps

Continue to the tutorial to learn how to create a site with custom assets, styles, scripts, templates and themes, and where to publish everything for free.

For developers, the Readme provides instructions on how to download, install and extend markdown-pages, and the Change Log keeps track of its versions.