#markdown-html #markdown #blog #html #static #generator

app orion-ssg

A static site generator to create a simple blog from Markdown files

16 stable releases

1.1.4 Jan 24, 2024
1.1.3 Oct 31, 2023
1.1.1 Jul 31, 2023
1.0.9 Feb 27, 2023
1.0.3 Nov 7, 2022

#268 in Value formatting

Download history 6/week @ 2024-01-19 81/week @ 2024-02-16 60/week @ 2024-02-23 31/week @ 2024-03-01 2/week @ 2024-03-08 46/week @ 2024-03-29 18/week @ 2024-04-05

73 downloads per month

GPL-3.0 license

876 lines


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

CLI Actions

  • orion init [PATH] : create a directory to start a new Orion blog (with a few fake posts)
  • orion post [SLUG] : create a new Markdown post
  • orion build : export the Markdown to html
  • orion serve : build, start a local server to test your build, and watch for changes on /posts, /static and /themes
  • orion --version : display the current version of Orion

You can use the --help or -h flag for each action to know more

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: 2022-11-01 11:12:13
image: https://www.publicdomainpictures.net/pictures/220000/velka/orion-nebula.jpg

The actual markdown content


The favicon was made by Denis Moskowitz from the Noun Project.


~861K SLoC