markdown-accessibility

Audit markdown files for WCAG accessibility violations with severity scores.

Updated Aug 16, 2025
One-click install
npx skills add https://github.com/dodyg/blue-nile-pds --skill markdown-accessibility-dodyg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-accessibility
Source: https://github.com/dodyg/blue-nile-pds/tree/main/.agents/skills/markdown-accessibility
Command: npx skills add https://github.com/dodyg/blue-nile-pds --skill markdown-accessibility-dodyg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many markdown documents lack proper accessibility, causing issues with ambiguous links, missing alt text, improper heading structures, inaccessible diagrams, and emoji misuse, which violate WCAG standards.

Core Features & Use Cases

  • Domain Coverage: Detects problems in links, images, headings, tables, emojis, Mermaid/ASCII diagrams, and anchor validation.
  • Severity Scoring: Assigns critical, serious, moderate, or minor scores with auto‑fix suggestions where possible.
  • Fix Templates: Provides ready‑to‑apply markdown snippets and translation maps for emojis and diagrams.

Quick Start

Ask the markdown-accessibility skill to audit your README.md and receive a scored accessibility report with fix recommendations.

Frequently Asked Questions about markdown-accessibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check markdown files for WCAG accessibility violations?

You can check markdown files for WCAG accessibility violations by auditing link text, image alt text, heading hierarchy, tables, emojis, and diagrams to identify issues and generate fix templates.

How do I fix missing alt text and improper heading hierarchy in markdown documentation?

Fix missing alt text and improper heading hierarchy in markdown by running an accessibility audit that detects these structural issues and provides ready-to-apply markdown snippets as corrections.

Does markdown accessibility linting cover emojis and Mermaid diagrams?

Markdown accessibility linting covers emojis and Mermaid diagrams by detecting misuse, validating anchor links, and providing severity scores alongside translation maps and fix templates for these elements.

What is the best way to score the severity of markdown accessibility issues?

The best way to score markdown accessibility issues is to evaluate elements like links and tables against WCAG guidelines, assigning critical, serious, moderate, or minor severity scores to prioritize fixes.

When should I audit anchor links and tables in markdown for accessibility?

You should audit anchor links and tables in markdown whenever you publish documentation, as invalid anchors and poorly structured tables violate WCAG standards and create barriers for screen reader users.

Can I automatically generate fix templates for inaccessible markdown?

You can automatically generate fix templates for inaccessible markdown by auditing the document, which yields ready-to-apply snippets and translation maps to correct issues across links, images, and diagrams.