MokaDocs

The modern documentation site generator built for .NET libraries.

Get Started View on GitHub

Everything you need

A modern documentation toolkit built for .NET developers

C#
C# API Reference

Auto-generate API docs from your .NET assemblies with full type information and XML doc comments.

</>
Beautiful Themes

Ship with a polished default theme or build your own with Scriban templates and CSS variables.

Instant Search

Client-side full-text search with zero external dependencies. Works offline and loads instantly.

Dark Mode

Automatic light and dark mode with system preference detection and manual toggle support.

v2
Versioning

Maintain docs for multiple versions side by side. Readers can switch between releases seamlessly.

Plugin System

Extend the build pipeline with custom plugins for content transforms, assets, and more.

Simple configuration

Get a docs site running in under a minute

yaml
# mokadocs.yaml
title: My Project
description: Docs for my .NET library
theme: default
nav:
  - label: Getting Started
    path: docs/getting-started.md
  - label: API Reference
    path: api/

Quick Start

1

Install MokaDocs

Install the MokaDocs CLI as a .NET global tool:

dotnet tool install -g mokadocs
2

Initialize Your Project

Create a new documentation project in your library's directory:

mokadocs init
3

Start Writing

Launch the dev server with hot reload:

mokadocs serve

Key Features

Packages

Package Description
Moka.Docs.Core Core models, configuration, and interfaces
Moka.Docs.CLI Command-line interface (mokadocs tool)
Moka.Docs.Engine Build pipeline and phase orchestration
Moka.Docs.Parsing Markdown parsing with custom extensions
Moka.Docs.Rendering Scriban template engine integration
Moka.Docs.CSharp Roslyn-based C# API analysis
Moka.Docs.Themes Theme management and default theme
Moka.Docs.Plugins Plugin system and built-in plugins
Moka.Docs.Search Client-side search index generation
Moka.Docs.Serve Dev server with hot reload and REPL
Moka.Docs.Versioning Multi-version documentation support
Moka.Docs.AspNetCore ASP.NET Core integration middleware