Netdocs

Netdocs is a fast, flexible static site generator written in .NET 11. It reimplements the Material for MkDocs experience with a first-class C# plugin system. Site configuration lives in appsettings.json, and Markdown in docs/ builds with little to no change.

Attribution

Netdocs is an AI-generated derivative work inspired by, and partially reusing files from, MkDocs and Material for MkDocs. Full credit for the theme, its compiled CSS/JS, the lunr-based search, and the overall design goes to Martin Donath (@squidfunk) and contributors. If you want a supported, production-grade tool, use Material for MkDocs directly and consider sponsoring it.

Why Netdocs?

Material look and feel — vendored Material CSS/JS, lunr search, social cards.
Configuration in appsettings.json — the Netdocs section, via Microsoft.Extensions.Configuration.
Fast parallel builds — a parallel render pipeline over Markdig.
C# plugin system — blog, tags, search, social, snippets, and more, all extensible.
Live reload — netdocs serve runs Kestrel with a WebSocket live-reload watcher.

Quick links

Installation — build or install the CLI.
Quick start — scaffold and build a site.
Configuration — the appsettings.json schema.
Plugins — the built-in plugin catalogue.
Publishing — deploy to GitHub Pages.

At a glance

# Build a site (looks for ./appsettings.json, or pass --config)
netdocs build

# Serve with live reload
netdocs serve --port 8000

See Getting started to go from zero to a running site.