DocAnvil

A static documentation generator that turns Markdown into beautiful HTML sites.

Quick Start

# Install
cargo install --path .

# Create a new docs project
docanvil init my-docs

# Start the dev server with live reload
cd my-docs
docanvil serve

Open http://localhost:3000 in your browser and start writing.

Features

Markdown with GFM — tables, task lists, strikethrough, footnotes, and front matter via comrak
Wiki-links — connect pages with double-bracket links
Components — notes, warnings, tabs, and code groups using :::directive blocks
Theming — CSS variables, custom stylesheets, and full template overrides with Tera
Live reload — edit a file and your browser refreshes automatically
Static output — build to plain HTML and deploy anywhere

Explore the Docs

Section	What You'll Learn
Installation	Install DocAnvil and create your first project
Configuration	Customize `docanvil.toml` and `nav.toml`
Theming	CSS variables, custom CSS, and template overrides
Markdown	All supported Markdown and GFM features
Links & Popovers	Wiki-link syntax and inline popovers
Components	Notes, warnings, tabs, and code groups
CLI Commands	Every command, flag, and option
Project Structure	Directory layout and page discovery
CSS Variables	Complete variable reference with defaults

Getting started?

Run docanvil serve in your project directory and open your browser — every change you save will appear instantly.