mokadocs 1.4.0

MokaDocs

The modern documentation site generator built for .NET libraries.

Point MokaDocs at your .csproj and docs/ folder — it auto-discovers your API surface, parses XML docs, and generates a complete documentation site.

Quick Start

dotnet tool install -g mokadocs
mokadocs init
mokadocs serve

Features

• C# API Reference — Auto-generated from assemblies with full type info, XML comments, and <inheritdoc/> support
• Markdown Guides — Admonitions, tabs, code groups, task lists, footnotes, and more
• Interactive REPL — Run C# code directly in the browser (Roslyn-powered)
• Full-Text Search — Client-side instant search with Ctrl+K / Cmd+K
• 5 Color Themes — Ocean, Emerald, Violet, Amber, Rose with live switcher
• 7 Code Themes — Catppuccin, GitHub, Dracula, One Dark, Nord
• Dark/Light Mode — Auto-detects system preference
• Hot Reload — File watcher + WebSocket for instant preview
• Versioning — Multi-version docs with dropdown selector
• ASP.NET Core Integration — Embed docs directly in your web app

ASP.NET Core Integration

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMokaDocs(options =>
{
    options.Title = "My API Docs";
    options.Assemblies = [typeof(MyService).Assembly];
});

var app = builder.Build();
app.MapMokaDocs("/docs");
app.Run();

Configuration

site:
  title: "My Library"
  description: "Documentation for My Library"

content:
  docs: ./docs
  projects:
    - path: ./src/MyLibrary/MyLibrary.csproj

theme:
  options:
    primaryColor: "#0ea5e9"
    codeTheme: catppuccin-mocha
    codeStyle: macos

plugins:
  - name: mokadocs-repl
  - name: mokadocs-changelog

Packages

Links

• GitHub
• Documentation
• License: MIT