Mandu

A static site generator written in Rust to create a simple blog from Markdown files.

CLI Actions

• mandu init --path my-blog : create a directory to start a new Mandu blog (with a few fake posts)
• mandu post --slug my-amazing-title --draft : create a new Markdown post
• mandu build : export the Markdown to html
• mandu serve : build, start a local server to test your build, and watch for changes on /posts, /static and /themes
• mandu --version : display the current version of Mandu
• mandu --help : print the help

Directory structure

.
├── posts
├── build.sh
├── config.toml
├── public
├── static
└── themes

/posts Contains all the markdown files for your posts

build.sh A build script to use in CI/CD environments

config.toml The configuration of your site

/public The build directory (the files that will be deployed into production)

/static All the assets you want to use (images for your posts, for example)

/themes It contains the different themes you can use, each folder representing them with its own assets: html layout, css, images, ...

Front matter

You can use the following values in your posts. They will be located at the top of the file in between ---.

---
title: My great title
description: This is a small summary of my post
published_at: 2025-01-01 11:12:13
image: https://plus.unsplash.com/premium_photo-1700746098867-29b475283b51?q=80&w=500&auto=format
---

The actual markdown content