Slug

created feb 07 26
last modified mar 16 26
tags #project

a static site generator for Obsidian vaults, written in Rust.

WARNING: not designed for general use! the templates and deploy script are specific to my setup.

what it does

  • reads markdown from vault/10 Public/
  • resolves [[wikilinks]], backlinks, and ![[attachments]]
  • protects LaTeX from the markdown parser
  • renders via Tera templates
  • generates a plain-text site map, RSS feed, and sitemap
  • incremental builds via a file modification cache

usage

cargo run --release   # build to public/
./deploy.sh           # build + push to gh-pages

structure

vault/10 Public/   # source markdown
templates/         # tera html templates
static/            # assets
src/               
public/            # output