Markdown Accessibility

Auditing markdown documentation for WCAG compliance involves checking alt text, heading hierarchy, descriptive links, and table accessibility. This Skill automates that scan across all .md files and generates a MARKDOWN-ACCESSIBILITY-AUDIT.md report with severity scores and per-file scorecards.

A markdown accessibility audit includes checks for descriptive links, alt text, heading hierarchy, table accessibility, emoji usage, diagram alternatives, em-dash normalization, and anchor link validation to ensure documentation is fully usable.

To fix markdown accessibility issues automatically, the scanner identifies problems and applies safe fixes directly to the files, while flagging complex issues for manual review. This workflow ensures safe remediation tracked within the generated audit report.

Yes, you can check markdown tables and diagrams for accessibility. The audit evaluates table structures and verifies that diagrams include proper alternative text, ensuring all visual content meets WCAG standards.

Yes, this markdown audit works for an entire project directory by scanning all .md files in the current path. It provides a comprehensive breakdown of issues and generates a per-file scorecard for the whole scope.