Updated: · By · Permalink
Build a static site from Markdown and a shared HTML layout.
Zas
Zas is a static site generator written in Go. It walks a site's files, renders Markdown and HTML through a shared layout, and copies ordinary assets into the deploy directory. The source directory structure becomes the site's URL structure.
Install and start
The current source requires Go 1.26 or newer.
go install github.com/darccio/zas/cmd/zas@latest
mkdir my-site
cd my-site
zas init
Write index.md, edit .zas/layout.html, and build:
zas -full
The generated site is in .zas/deploy by default. Upload that directory to your static host.
zas init preserves an existing configuration and layout. zas init -force replaces both with scaffolded defaults.
These guides describe the current source. For reproducible builds, install a selected release tag or commit instead of @latest, and choose a revision containing the features you use.
Guides
- Configuration: site settings, page overrides and languages.
- Templates and plugins: layouts, metadata, embeds and the trust model.
- Publishing: sitemaps, RSS, Markdown twins and deployment.
Project links
Zas retains its module path github.com/darccio/zas. Hosting these guides on dario.cat does not change how Go users install or import it.
License
Zas and these docs are distributed under the GNU Affero General Public License, version 3, or any later version.
Source: Zas at d89a28125f63. AGPL-3.0-or-later license. Documentation index · Full documentation.