June is a super simple single page static site generator for Markdown files, written in Go. It is designed for quick, automated generation of single-page sites, landing pages, or any Markdown-to-HTML workflow — especially in automated deployments.
- Markdown to HTML: Instantly convert Markdown files to static HTML.
- Content-focused: Write your content as a regular Markdown file and get HTML out.
- Frontmatter Support: Optionally add metadata like title, description, and language with YAML to enhance the output.
- Simple: Fully self contained. Includes an embedded default template to let you generate pages with one binary and one Markdown file.
- Custom Templates & Styles: Use your own Go HTML templates and CSS, or stick with the built-in defaults.
- User-Generated Content Mode: Want to integrate June to publish untrusted Markdown? Enable a single flag to sanitise input.
june generate <input.md> [-o public/output.html] [--style ./custom.css] [--template ./template.gohtml] [--ugc] [--watch]
^ give a default too ^ switches theme ^ optional custom template ^ sanitises markdown as UGCjune versionGiven a Markdown file with frontmatter:
---
title: "My Page"
description: "A simple static page"
lang: "en"
---
# Hello World
Welcome to my page!Run:
june generate mypage.mdThis will produce public/index.html using the default template and style.
- Custom CSS:
Use--style ./your.cssto apply your own CSS file. - Custom Template:
Use--template ./your.gohtmlto use a custom Go HTML template.
The template receives all frontmatter fields,.Content(HTML), and.Style(CSS).
title: Sets the HTML<title>.description: Sets the meta description.lang: Sets the<html lang="">attribute.tags: (optional) Array of tags.
Use --ugc to treat the Markdown as untrusted user content. This strips all HTML and only allows safe Markdown.
Use --watch to keep June running and regenerate the output HTML whenever the input Markdown file changes.
Download a release from GitHub Releases or build from source:
go install github.com/kscarlett/june/cmd/june@latestContributions are very welcome! If you have ideas, bug fixes, or improvements, please open a pull request.
For questions or suggestions, feel free to open an issue.
MIT
For more details, see the examples directory or open an issue!