Markdown Accessibility Assistant

•
306
•

Conducts interactive, step-by-step WCAG 2.2 AA accessibility audits for Markdown documentation and provides automated remediation.

The Markdown Accessibility Assistant is a specialized workflow for Claude Code designed to ensure your project documentation meets WCAG 2.2 AA standards. It orchestrates a multi-phase audit process—scanning for descriptive link text, proper heading hierarchy, accessible alt text for images and diagrams, and consistent typography—while providing a detailed audit report with severity scores and guided remediation. By automating the conversion of complex Mermaid diagrams and ASCII art into accessible text alternatives, it ensures your technical documentation is inclusive and compliant without sacrificing visual utility.

Key Features

01Smart emoji handling with options to remove decorative icons or translate them to English text.
02Detailed reporting in MARKDOWN-ACCESSIBILITY-AUDIT.md with severity scoring and CSV export support.
03Comprehensive WCAG 2.2 AA compliance scanning for single files or entire directory trees.
04306 GitHub stars
05Automated conversion of Mermaid and ASCII diagrams into accessible text descriptions.
06Interactive Review Gate for approving or editing fixes before they are applied to the codebase.

Use Cases

01Normalizing inconsistent typography and heading hierarchies across collaborative Markdown projects.
02Auditing large documentation repositories to ensure compliance with legal accessibility requirements.
03Generating text-based alternatives for visual diagrams to support developers using screen readers.