Repository navigation
🎉 First stable release of the comprehensive MkDocs documentation template
Features
- Complete MkDocs configuration with Material theme and advanced features
- Professional documentation structure with getting started guides, architecture docs, user guides, and more
- Advanced pre-commit configuration for Python, Markdown, YAML, and JSON quality control
- Custom CSS with professional styling, component badges, and responsive design
- Comprehensive tooling: Black, isort, flake8, mypy, bandit, yamllint, markdownlint
- Security scanning with detect-secrets and spell checking with typos
- Automated setup script for easy project initialization
- Production-ready configuration for technical documentation projects
What's Included
📁 Complete Template Structure
- MkDocs configuration with Material theme
- Professional documentation structure
- Custom CSS with component styling
- Pre-commit hooks for quality control
- Automated setup scripts
🛠️ Development Tools
- Python code formatting (Black, isort)
- Linting (flake8, yamllint, markdownlint)
- Security scanning (bandit, detect-secrets)
- Spell checking (typos)
- Type checking (mypy)
🎨 Professional Features
- Modern Material Design theme
- Dark/light mode support
- Mermaid diagram support
- Custom component badges and status indicators
- Professional typography and responsive design
Quick Start
# Clone the template
git clone https://github.com/brunseba/_template_docs.git
cd _template_docs
# Run the setup script
./setup-precommit.sh
# Start developing
mkdocs serveDocumentation
Full documentation is available in the repository README and the included documentation template itself.
This template provides everything needed to create professional, maintainable technical documentation with modern tooling and best practices built-in.