guidebook

A fast, HonKit/GitBook-compatible static site generator written in Rust.

Quick Start

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/guide-inc-org/guidebook/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/guide-inc-org/guidebook/main/install.ps1 | iex

Via Cargo (alternative):

cargo install guidebook

Create and Preview a Book

# Navigate to your book folder (with SUMMARY.md)
cd your-book

# Start preview server with hot reload
guidebook serve

# Open http://localhost:4000

Build for Production

guidebook build -o _book

Update

guidebook update

Features

• Fast - Built with Rust for maximum performance
• HonKit/GitBook Compatible - Drop-in replacement
• Hot Reload - Live preview with auto-refresh
• Multi-language Support - Build books in multiple languages
• Mermaid Diagrams - Native support for diagrams
• Collapsible Chapters - Expandable sidebar navigation
• Full-text Search - Built-in search functionality
• Self-update - Update with a single command

Project Structure

your-book/
├── book.json       # Configuration (optional)
├── README.md       # Introduction
├── SUMMARY.md      # Table of contents
└── chapter1.md

SUMMARY.md

# Summary

* [Introduction](README.md)
* [Chapter 1](chapter1.md)
  * [Section 1.1](chapter1/section1.md)

Migration from HonKit

guidebook is a drop-in replacement for HonKit. Just install and run:

# Replace: npx honkit build
guidebook build

# Replace: npx honkit serve
guidebook serve

No configuration changes required.

License

MIT