MoonBlox

A Markdown-first programmable site generator powered by MoonBit.

Write Markdown, embed interactive MoonBit components, and moonblox-cli build outputs a static site.

Try It

See a live demo of components sharing state: Component Interaction Playground

Quick Start

Requires the MoonBit toolchain.

moon install xz-xuezhe/moonblox-cli
moonblox-cli init my-site
cd my-site
moonblox-cli serve        # dev server with live reload
moonblox-cli build        # production build

Open http://localhost:3000. Edit any Markdown file — the browser reloads automatically.

Examples

---
title: Hello MoonBlox
date: 2025-01-15
tags: [demo]
---

@badge(text: "new", tone: "info")

:::callout(type: "note", title: "Tip")
Regular **Markdown** content here.
:::

::score_panel { count = 0 }
  @metric(value=count, label="Clicks")
  @chart(value=count, max=10, label="Progress")
  @counter(value=count)
::

• Inline @name(args) — embed a component anywhere in a line
• Container :::name(args) — wrap Markdown content in a component
• Structured block ::name { model } body :: — share state across multiple components

Library

To use MoonBlox as a MoonBit library:

moon add xz-xuezhe/moonblox

Documentation

Full docs at xz-xuezhe.github.io/moonblox:

• Getting Started
• Syntax Reference
• Components
• Configuration

License

Apache 2.0