Marmite [Markdown makes sites] is a very! simple static site generator.
I'm a big user of other SSGs but it is frequently frustrating that it takes so much setup to get started.
Just having a directory of markdown files and running a single command sounds really useful.
— Michael, marmite user.
It does "one" simple thing only:
.md
files on the input
directory.CommonMark
parse it to HTML
content.frontmatter
or filename
.html
file for each page.output
folder.It also handles generating or copying static/
and media/
to the output
dir.
./{name}.html|rss|json
tags:
(to group similar content together) and stream:
(to separate content in a different listing) date:
attribute to differentiate posts
from pages
:smile:
, spoiler ||secret||
.[[name|url]]
and Obsidian links [[page]]
.og:
tags.Install with cargo
cargo binstall marmite
or
cargo install marmite
Or download the pre-built binary from the releases
It's simple, really!
$ marmite folder_with_markdown_files path_to_generated_site
Site generated at path_to_generated_site/
CLI
❯ marmite --help
Marmite is the easiest static site generator.
Usage: marmite [OPTIONS] <INPUT_FOLDER> <OUTPUT_FOLDER>
Arguments:
<INPUT_FOLDER> Input folder containing markdown files
<OUTPUT_FOLDER> Output folder to generate the site
Options:
--serve Serve the site with a built-in HTTP server
--watch Detect changes and rebuild the site automatically
--bind <BIND> Address to bind the server [default: localhost:8000]
--config <CONFIG> Path to custom configuration file [default: marmite.yaml]
--debug Print debug messages Deprecated: Use -vv for debug messages
--init-templates Initialize templates in the project
--start-theme Initialize a theme with templates and static assets
--generate-config Generate the configuration file
-v, --verbose... Verbosity level (0-4) [default: 0 warn] options: -v: info,-vv: debug,-vvv: trace,-vvvv: trace all
-h, --help Print help
-V, --version Print version
Read a tutorial on how to get started https://rochacbruno.github.io/marmite/getting-started.html and create your blog in minutes.
Read more on how to customize templates, add comments etc on https://rochacbruno.github.io/marmite/
Marmite is very simple.
If this simplicity does not suit your needs, there are other awesome static site generators.
Here are some that I recommend: