# MinimalDoc

> A minimal static site generator for documentation. Fast, clean, and easy to use.

## Features

- [Feature Index](http://localhost:8888/features/index.html): Complete list of all MinimalDoc features
- [Features Overview](http://localhost:8888/features/overview.html): Complete feature list and capabilities of MinimalDoc
- [Search](http://localhost:8888/features/search.html): Client-side full-text search with keyboard shortcuts
- [Theming](http://localhost:8888/features/theming.html): Customize appearance with CSS variables and custom themes
- [Admonitions](http://localhost:8888/features/admonitions.html): Callout blocks for important information, warnings, and tips
- [Code Highlighting](http://localhost:8888/features/code-highlighting.html): Syntax highlighting for 100+ programming languages
- [SEO](http://localhost:8888/features/seo.html): Search engine optimization features including sitemap, meta tags, and Open Graph
- [LLMs.txt](http://localhost:8888/features/llms-txt.html): Generate LLM-friendly documentation for AI assistants
- [Landing Pages](http://localhost:8888/features/landing-pages.html): Create beautiful landing pages, portfolios, and contact pages
- [Multi-Version Documentation](http://localhost:8888/features/multi-version.html): Maintain documentation for multiple software versions with version-specific content and overrides
- [Internationalization (i18n)](http://localhost:8888/features/i18n.html): Multi-language documentation with locale-specific translations, RTL support, and language switching
- [Analytics](http://localhost:8888/features/analytics.html): Plugin-based analytics system with support for multiple providers
- [MCP Server Documentation](http://localhost:8888/features/mcp-docs.html): Publish static reference pages for MCP servers from JSON manifests
- [PDF Export](http://localhost:8888/features/pdf-export.html): Export documentation pages as PDF files
- [Claude Assist](http://localhost:8888/features/claude-assist.html): Add an AI assistant button to documentation pages

## Api Reference

- [CLI Commands](http://localhost:8888/api-reference/cli.html): Command-line interface reference
- [Config Schema](http://localhost:8888/api-reference/config-schema.html): Complete config.yaml schema reference
- [Templates](http://localhost:8888/api-reference/templates.html): Starter templates for documentation content

## Changelog

- [Changelog Overview](http://localhost:8888/changelog/overview.html): Track releases with versioned changelog
- [Changelog Format](http://localhost:8888/changelog/format.html): Release file format, categories, and semver

## Core Concepts

- [Project Structure](http://localhost:8888/core-concepts/project-structure.html): Understanding MinimalDoc directory layout and file organization
- [Markdown Syntax](http://localhost:8888/core-concepts/markdown-syntax.html): Supported Markdown syntax and GitHub Flavored Markdown extensions
- [Frontmatter](http://localhost:8888/core-concepts/frontmatter.html): YAML frontmatter schema for page metadata and configuration
- [Navigation](http://localhost:8888/core-concepts/navigation.html): Configure navigation with folder structure or custom TOC.md

## Getting Started

- [Installation](http://localhost:8888/getting-started/installation.html): Install MinimalDoc on your system
- [Quick Start](http://localhost:8888/getting-started/quick-start.html): Create your first MinimalDoc site in minutes
- [Configuration](http://localhost:8888/getting-started/configuration.html): Complete config.yaml reference for MinimalDoc

## Guides

- [Deployment](http://localhost:8888/guides/deployment.html): Deploy MinimalDoc sites to any static hosting
- [GitHub Pages](http://localhost:8888/guides/github-pages.html): Deploy documentation to GitHub Pages
- [Custom Themes](http://localhost:8888/guides/custom-themes.html): Create custom themes with CSS variables
- [Prometheus Integration](http://localhost:8888/guides/prometheus-integration.html): Automate status page updates with Prometheus AlertManager
- [Roadmap Pages](http://localhost:8888/guides/roadmap-pages.html): Add a visual roadmap to your documentation site
- [Portfolio](http://localhost:8888/guides/portfolio.html): Project showcase with filterable tags and individual project pages
- [Knowledge Base](http://localhost:8888/guides/knowledge-base.html): Categorized help articles with search and structured navigation
- [FAQ Pages](http://localhost:8888/guides/faq.html): Frequently asked questions with categories and collapsible answers
- [Contact Page](http://localhost:8888/guides/contact-page.html): Add a contact page with info cards
- [Legal Pages](http://localhost:8888/guides/legal-pages.html): Privacy policy, terms of service, and other legal pages

## Openapi

- [OpenAPI Overview](http://localhost:8888/openapi/overview.html): Interactive API documentation from OpenAPI/Swagger specifications
- [OpenAPI Configuration](http://localhost:8888/openapi/configuration.html): Configure OpenAPI documentation generation
- [OpenAPI Views](http://localhost:8888/openapi/views.html): Organize API endpoints by path, tag, or flat list
- [API Testing](http://localhost:8888/openapi/testing.html): Interactive API testing with Try It interface
- [Authentication](http://localhost:8888/openapi/authentication.html): Configure API authentication for testing
- [Code Samples](http://localhost:8888/openapi/code-samples.html): Auto-generated code examples for API endpoints
- [Schemas](http://localhost:8888/openapi/schemas.html): Browse and explore API data models

## Status Page

- [Status Page Overview](http://localhost:8888/status-page/overview.html): Service health dashboard with incidents and uptime tracking
- [Components](http://localhost:8888/status-page/components.html): Define and configure service components
- [Incidents](http://localhost:8888/status-page/incidents.html): Document and track service incidents
- [Scheduled Maintenance](http://localhost:8888/status-page/maintenance.html): Plan and communicate maintenance windows
- [Uptime Tracking](http://localhost:8888/status-page/uptime-tracking.html): Track service availability with uptime grid and SLA display
- [Health Checks](http://localhost:8888/status-page/health-checks.html): Static and real-time approaches to service monitoring

## Documentation

- [MinimalDoc](http://localhost:8888/index.html): A modern, minimal static site generator for beautiful documentation

## Optional

- [Complete Documentation](http://localhost:8888/llms-full.txt): All documentation in a single file