Mantle CLI v0.8.1

Static sites from plain text.

Mantle turns a folder of Markdown files into a fast, dependency-free website. One command installs it, one command builds it.

Install Mantle Read the reference

terminal

$ mantle init my-website
$ cd my-website
$ mantle build
$ mantle serve

Principles

Plain text in, static HTML out

Mantle reads Markdown, applies a template, and writes complete HTML. No server, no runtime, no database. The output works from any file host.

Slow by design, fast at runtime

Mantle takes longer to build than a single-page app, but each page is a static file that loads immediately. The build step is the only step.

"The site is the artifact, not the interface to a backend."

How a build works

Mantle reads every file in a project, maps the folder structure to URLs, and applies a layout. It then writes the finished HTML to a public directory ready for any web server.

terminal

$ mantle build
Compiling 42 pages...
Writing public/index.html
Writing public/about/index.html
Done in 1.2s

Start with the quick start

Follow the guided tutorial to create your first Mantle site in under five minutes. It covers project structure, Markdown, and the local development server.

Open quick start