Setup¶
Material for MkDocs offers a wide range of options for customizing your documentation. In this section, we will explain how you can create a meaningful structure for your site, change the look and feel, add a blog and comment system, and build a highly optimized site.
Site structure¶
Set up and customize the structure of your documentation by configuring the header and footer to your taste, choosing among many modes of navigation, setting up site search, and more.
Language – Choose out of the 60+ supported languages or add a new one
Navigation – Create a clear, concise, and comprehensive navigation structure
Header – Customize the behavior of the header, add an announcement bar
Footer – Add links to your social media profiles or websites in the footer
Search – Set up and configure search, running entirely in the user’s browser
Tags – Categorize your pages with tags and group related pages
Appearance¶
Match your brand’s colors, fonts, icons, logo, and more with a few lines of configuration – Material for MkDocs makes it easy to extend the basic configuration or alter the appearance.
Colors – Change colors with an existing color palette or customize with CSS
Fonts – Choose among 1,000 Google Fonts or load self-hosted fonts
Logo & Icons – Change the logo, use any of the 8,000+ icons, or add new ones
Social Cards – Automatically create social media previews when sharing links
Content¶
Create a blog, integrate a comment system, connect a git repository, and set up versioned documentation that matches your project’s versioning methodology.
Blog – Set up a standalone blog or host it alongside your documentation
Comment System – Add a third-party comment system on any page or footer
Versioning – Deploy multiple versions by integrating with external utilities
Repository – Connect your documentation to your git repository
Optimization¶
Add site analytics and build an optimized site by adding automatic image compression, complying with GDPR data privacy regulations, and making it offline-capable.
Site analytics – Learn how your users experience your documentation
Optimized site – Create optimized sites that rank great on search engines
Data Privacy – Ensure compliance with data privacy regulations
Offline usage – Build an online and offline-capable documentation