RMSG is an opinionated static site generator built specifically for my personal website rmunoz.xyz. It transforms Markdown files with YAML frontmatter into a complete static HTML site.

Project Goal

This tool exists to generate my personal website with zero compromises. Rather than wrestling with the complexity and feature bloat of general-purpose static site generators, RMSG does exactly what I need and nothing more. It’s built around a single YAML configuration file that defines the entire site structure, making it simple to understand and maintain.

Inspiration

The design and aesthetic of this site generator was inspired by:

• martinheinz.dev - Clean, minimalist personal site design
• jmoiron.github.io/sqlx - Simple, effective documentation layout

Features

• Markdown to HTML: Write content in Markdown with YAML frontmatter
• Three Page Types: page, post, and project with appropriate rendering
• Custom Post and Projects Listings: Use :post-list or :project-list in Markdown to automatically generate lists of posts or projects with links, dates, and descriptions. Projects can also have a thumbnail image. Optionally limit number of elements displayed (e.g. :post-list 5).
• Automatic Tag Pages: Tag index pages generated automatically from frontmatter tags
• Reading Time Estimation: Automatic reading time calculation for posts based on word count (200 words per minute and rounded to nearest 5 minutes)
• Syntax Highlighting: Code blocks are automatically highlighted using Chroma with the Catppuccin Latte theme
• Glob Pattern Support: Use posts/*.md to include multiple files
• YAML Configuration: Single site.yaml file defines the entire site structure. Site hero image, title and navigation menu can be set here.
• Static Assets: Copy static files (images, CSS) from src/static/ to output
• Embedded Templates: HTML templates and CSS bundled in the binary
• Draft Support: Mark pages as is_draft: true to exclude from build
• Built-in Dev Server: Preview with rmsg serve
• Schema Validation: JSON schema provided for site.yaml validation

To know more about the project checkout the source code in Sourcehut.