bim

A Content-First Static Site Generator

Philosophy

Markdown as primary format
Filesystem as configuration
No front matter
Warnings, not errors

Quick Start

# Install
cargo install bim

# Build
bimbuild

# Serve
bimserve --watch

Directory Structure

my-site/
  index.md        # Homepage
  nav.md          # Navigation
  blog/           # Date-sorted posts
  notes/          # Hierarchical garden
  snippets/       # Code files
  images/         # Processed images
  static/         # Copied as-is
  layouts/        # HTML templates

Collections

Collection	Structure	Features
blog	flat	RSS, dates
notes	hierarchical	auto-index
snippets	flat	syntax highlight
slides	flat	no backlinks

Tags & Contexts

This is about [#rust](/tags/rust/) programming.

It applies to [@linux](/contexts/linux/) systems.

Auto-generates:

/tags/rust/
/contexts/linux/

Backlinks

Link from anywhere...

See [my other post](/blog/post/)

...backlinks appear automatically!

Directives

Dynamic content in Markdown:

## Recent Posts


  مرحبا بكم في bim 2024-04-01
  How bim Works 2024-03-15
  Building a Digital Garden with Backlinks 2024-03-01
  Tags and Contexts Explained 2024-02-15
  Markdown Features in Vibe Site 2024-02-01

Layouts

Simple placeholder substitution:

<title>{{title}}</title>
<main>{{content}}</main>

No template logic. Keep it simple.

Image Processing

Automatic resize
EXIF stripping
Quality optimization
Caching

Built With

Rust - Fast and safe
pulldown-cmark - Markdown
syntect - Highlighting
git2 - Date extraction
axum - Dev server

Get Started

cargo install bim
mkdir my-site && cd my-site
echo "# Hello" > index.md
bimserve

bim