MkDocs is a Python-powered documentation site generator — with the Material for MkDocs theme boasting 20K+ GitHub stars — but as a static site generator it has no built-in WCAG accessibility audit, no Core Web Vitals scoring, and no post-deployment health monitoring. PageGuard audits the live deployed URL of any MkDocs documentation site externally — free, no source code needed, results in 30 seconds.
ADA Title II Deadline: April 24, 2026
State and local government websites must meet WCAG 2.1 AA by April 24, 2026. Government agencies, federal research laboratories, universities, and public health organizations frequently use MkDocs with Material for MkDocs to publish official documentation portals and technical guides. Material for MkDocs theme upgrades, new plugin integrations, and custom color scheme overrides can silently introduce accessibility regressions — particularly insufficient color contrast in custom palettes, missing ARIA labels on icon-only navigation buttons, keyboard focus issues in the search overlay, and custom JavaScript extensions lacking keyboard support. These issues only appear in the deployed HTML and require external runtime validation. PageGuard provides continuous post-deployment accessibility monitoring without modifying your mkdocs.yml or theme configuration.
| Feature | PageGuard | MkDocs |
|---|---|---|
| What is it? | External website health monitor — scans any URL for performance, accessibility, SEO, and best practices | Python-powered static documentation site generator — mkdocs.yml configuration, Markdown content, built-in dev server, and a plugin ecosystem; the wildly popular Material for MkDocs theme (20K+ GitHub stars) adds a modern design, tabbed content, admonitions, search, dark mode, social cards, and blog support; widely used in Python open source projects, data science, MLOps, and government documentation portals |
| Free tier | ✓ Yes — unlimited one-off scans, no signup required | Free and open source (BSD license); no SaaS pricing — install via pip, write Markdown, configure mkdocs.yml, run mkdocs serve or mkdocs build, deploy the static output to GitHub Pages, Netlify, Cloudflare Pages, or Read the Docs; Material for MkDocs Insiders edition adds premium features via GitHub Sponsors |
| Accessibility audit (WCAG / ADA) | ✓ Yes — WCAG 2.1 AA scored 0–100 with specific issue list | No — MkDocs generates static HTML from Markdown but has no built-in WCAG or ADA accessibility auditing; accessibility quality depends on the chosen theme (mkdocs, readthedocs, or Material for MkDocs) and any custom template overrides or JavaScript extensions used in the documentation project |
| Technical SEO audit | ✓ Yes — meta tags, headings, canonical, structured data | No — MkDocs generates meta tags from page metadata and a sitemap via mkdocs-sitemap plugin; Material for MkDocs adds social cards and Open Graph tags; but neither provides SEO audit scores, canonical validation, structured data completeness checks, or heading hierarchy analysis for the rendered output |
| Performance audit (Core Web Vitals) | ✓ Yes — LCP, CLS, FCP scored 0–100 per scan | No — Material for MkDocs uses optimized lazy loading and minified assets, but Core Web Vitals depend on the theme's CSS/JS, custom JavaScript extensions, and image handling in documentation content; no built-in CWV measurement or scoring for deployed documentation sites |
| Documentation site generator | No — PageGuard is a monitoring tool, not a site generator | ✓ Yes — MkDocs is purpose-built for project documentation: simple mkdocs.yml configuration, automatic navigation from directory structure, built-in search, Markdown extensions (admonitions, code blocks with syntax highlighting, tabs, details), and one-command deployment to GitHub Pages (mkdocs gh-deploy); Material for MkDocs adds versioned docs, blog plugin, social cards, and tags |
| Python ecosystem integration | No — PageGuard is a standalone monitoring service | ✓ Yes — MkDocs integrates naturally with Python projects: mkdocstrings automatically generates API reference pages from Python docstrings (Google/NumPy/Sphinx style), mkdocs-gen-files creates pages programmatically, and the plugin ecosystem includes mkdocs-jupyter for embedding Jupyter Notebooks as documentation pages; the de facto standard for Python package docs alongside Sphinx |
| Automated website monitoring | ✓ Yes — weekly or daily scans with email alerts on score drop | No — MkDocs is a static site generator; it has no post-deployment health monitoring, accessibility regression alerts, or uptime checking for the documentation sites it generates |
| AI-generated plain-English report | ✓ Yes — explains issues in non-technical language | No — no AI health report for sites built with MkDocs |
| ADA Title II compliance monitoring | ✓ Yes — WCAG audit + alert on accessibility regression | No — MkDocs does not audit or alert on WCAG compliance; Material for MkDocs has made significant accessibility improvements but theme upgrades and custom template overrides can introduce regressions; common issues include insufficient color contrast in custom color schemes, missing ARIA labels on icon-only navigation buttons, keyboard focus management in the search overlay, and custom JavaScript extensions that lack keyboard accessibility support — all requiring external runtime validation on the deployed site |
| Works on any platform | ✓ Yes — scans any URL on any front-end or platform | No — MkDocs builds your own documentation site only; it does not audit sites built by others or sites using different generators |
| Independent external audit | ✓ Yes — third-party scan, shareable URL for clients/stakeholders | No — no built-in tool to generate a shareable external health report for an MkDocs-generated documentation site |
| Instant on-demand scan | ✓ Yes — results in 30 seconds, no code changes needed | No — no on-demand health scan; external auditing of MkDocs sites requires separate tools like Lighthouse or axe after deployment |
| Multi-site dashboard | ✓ Yes — 1–50 sites depending on plan | MkDocs generates individual documentation sites; there is no health monitoring dashboard showing accessibility, SEO, and performance scores across multiple MkDocs deployments |
| Pricing for health monitoring | ✓ Free + from $9/mo for automated monitoring | Health monitoring not available — MkDocs is a static site generator, not a website health monitoring tool |
Get the WCAG accessibility score and Core Web Vitals for your deployed MkDocs site. Results in 30 seconds. No Python, MkDocs installation, or mkdocs.yml configuration required.
Results in ~30 seconds. 4 scores: Performance, Accessibility, SEO, Best Practices.
Yes — PageGuard scans the live deployed URL of any MkDocs documentation site hosted on GitHub Pages, Read the Docs, Netlify, Cloudflare Pages, or a self-managed server. Enter the public URL and receive a full health report in ~30 seconds covering Core Web Vitals, WCAG 2.1 AA accessibility, technical SEO, and best practices. No Python environment, MkDocs installation, or mkdocs.yml configuration access is required.
No — MkDocs generates static HTML from Markdown with no WCAG compliance checking. Material for MkDocs has improved accessibility but custom color scheme overrides can introduce contrast issues. Common problems include insufficient color contrast in custom palettes, missing ARIA labels on icon-only navigation buttons (search toggle, back-to-top), keyboard focus management gaps in the search overlay, and JavaScript extensions lacking keyboard accessibility. PageGuard audits your live MkDocs site and provides a WCAG 2.1 AA score with specific issues to fix.
MkDocs is widely used by government agencies, federal research labs, and nonprofits facing ADA Title II requirements by April 24, 2026. Material for MkDocs theme upgrades, new plugin integrations, and custom overrides can silently introduce accessibility regressions in interactive elements like the search overlay, versioned docs switcher, and navigation tabs. These regressions only surface in the deployed HTML and require external validation. PageGuard provides continuous monitoring without requiring changes to your mkdocs.yml or theme configuration.
No — they serve completely different purposes. MkDocs is a Python-powered documentation generator converting Markdown files into fast static documentation sites with a simple mkdocs.yml configuration and a rich plugin ecosystem for API reference generation and versioned docs. PageGuard is an external quality monitoring tool for the deployed output. Organizations running MkDocs documentation should use PageGuard to continuously monitor accessibility, SEO, and performance without modifying their existing MkDocs setup.