Introduction

Docyard is a static site generator for documentation. It transforms your Markdown files into a polished, searchable documentation website with sensible defaults and zero configuration.

gem install docyard
docyard init my-docs
docyard serve

Features

Syntax Highlighting

Over 100 languages supported out of the box with automatic language detection.

Full-Text Search

Pagefind-powered search that works entirely client-side. Fast, private, and offline-capable.

Dark Mode

Automatic theme switching based on system preferences, with manual toggle available.

Components

Callouts, tabs, code groups, steps, cards, and more. All with clean, consistent styling.

Responsive Design

Optimized for every screen size with touch-friendly navigation on mobile.

Deploy Anywhere

Generates static HTML that works on any hosting platform.

How It Works

1

Write

Create your documentation in Markdown. Organize files however you like - Docyard figures out the structure.

2

Preview

Run docyard serve to start a local server with hot reload. See your changes instantly.

3

Build

Run docyard build to generate optimized static files ready for production.

4

Deploy

Upload the output to GitHub Pages, Vercel, Netlify, or any static hosting service.

Built With Ruby

Docyard is distributed as a Ruby gem. A single install gives you everything - the CLI, the build system, and all dependencies bundled together.

Tip

Already have Ruby installed? You’re one command away from your first docs site.

Edit this page
Last updated