MDU
MDU is a .NET tool that turns a folder of ordinary Markdown files into a documentation site. Your pages stay plain Markdown that reads well on GitHub; MDU adds navigation, search, diagrams, and a polished theme when it renders them.
Get started
- Setup - Choose a .NET tool or portable installation
- Usage - Run the commands and preview your site
- Publish - Host the generated site on GitHub, GitLab, or any web server
Commands
| Command | Does |
|---|---|
| mdu tree | Shows the page structure |
| mdu lint | Finds broken links and structure problems |
| mdu fix | Migrates MkDocs syntax and applies automatic fixes |
| mdu serve | Previews the site with live reload |
| mdu render | Generates the static site |
| mdu pdf | Combines all pages into one PDF |
| mdu page | Moves pages and updates every link to them |
Write and organize content
- Features - Callouts, diagrams, math, icons, keyboard keys, and more
- Navigation - Order pages, add top tabs, and hide entries
- Repository Imports - Combine Markdown pages from multiple GitHub repositories
About MDU
- Architecture - How MDU reads, checks, and renders a documentation folder
- Other tools - Documentation site generators worth knowing