How to hack the zola blog engine

About zola

A fast static site generator in a single binary with everything built-in. https://www.getzola.org

How to install zola

MacOS and Linux can use the below command to install.

curl -fsSL https://github.com/getzola/zola/releases/latest/download/zola.tar.gz | tar xz
sudo mv zola /usr/local/bin/

How to create your first website

to create a new website is easy.

zola init myblog
cd myblog

Zola will ask some setup questions (like site title). It then creates this structure:

myblog/
 ├── config.toml
 ├── content/
 ├── templates/
 ├── static/
 └── themes/

Add content

Create a Markdown file:

zola new content/blog/first-post.md

Then edit it:

+++
title = "My First Post"
date = 2025-11-08
+++

Hello **world**, this is my first Zola post!

Add a theme (optional)

Go to https://www.getzola.org/themes/

Example:

git clone https://github.com/getzola/after-dark themes/after-dark

Then edit your config.toml:

theme = "after-dark"

Run local server

zola serve

Then open your browser: 👉 http://127.0.0.1:1111 It auto-rebuilds on file changes.

Build for production

zola build

It generates static HTML files in the public/ directory — you can host it anywhere (GitHub Pages, Netlify, Cloudflare Pages, etc.).

How embedded video (local, youtube)

  • load the local video
{ { video(src="video/myvideo.mp4") } }
  • load the youtube video
{ { video(youtube="hQp3_aWAfRA") } }