Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This is a project for generating and editing a static blog. It stores the necessary information in a folder structure and uses MarkDown files for the main content of each blog post to enable a mix between simplicity and customizability.

This project is still under development, so some of these detail might not be implemented yet.

An example of a generated site can be seen at

This is generated from the files at


You can try out the blog editor at


  • Default meta tags.
  • Automatic script and css inclusion
  • Chronologial post list
  • RSS feed generation with tagged feeds.

Solution structure

The solution is separated in 4 main projects.


This part is what actually generates the main page, blog post list, header tags, and each individual blog post in simple HTML files.


This part is a Blazor WASM project that uses the Blazor.FileSystemAccess project to open a local directory where you store your blog data and edit it. The editor can likewise call the templater to generate the output files to some specific folder.


This is a CLI tool that simply is able to open the files in a directory like the editor and then use the templating project to generate the necessary files before writing them to some output path.


This part is still to be decided. But the main idea is that this will be an API that can be used for analyze user behavior i.e. how many visits each post has (we don't need a cookie consent for that).

Later this data might be used to order some lists or show specific posts as "What to read next" in the bottom of each page.

Future priorities

For using the generator in something like an CI/CD pipeline it would be cool to have it as either an GitHub Actions package that can be added there or the more versatile approach, a dotnet tool.