markdown-accessibility

Audit and remediate Markdown documentation for WCAG accessibility compliance.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/josephblais/jeeby-cms --skill markdown-accessibility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-accessibility
Source: https://github.com/josephblais/jeeby-cms/tree/main/.github/skills/markdown-accessibility
Command: npx skills add https://github.com/josephblais/jeeby-cms --skill markdown-accessibility

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses common accessibility issues in Markdown documentation, ensuring content is usable by everyone, including those using assistive technologies.

Core Features & Use Cases

  • Audit & Fix: Identifies and helps correct problems like ambiguous links, missing image alt text, improper heading structures, and inaccessible diagrams.
  • Comprehensive Rules: Covers 9 domains of Markdown accessibility, including emoji handling and anchor link validation.
  • Use Case: When preparing a project's README file, use this Skill to automatically scan for and suggest fixes for any accessibility barriers, ensuring a high-quality, inclusive user experience.

Quick Start

Scan the markdown file located at '/path/to/your/document.md' for accessibility issues.

Frequently Asked Questions about markdown-accessibility

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

FAQPage Schema
How do I check my Markdown documentation for WCAG compliance?

To check Markdown documentation for WCAG compliance, scan the file to audit ambiguous links, image alt text, heading hierarchy, table descriptions, and diagram accessibility. The process applies pattern libraries and severity scoring to identify barriers and generate fix templates.

What is the best way to fix missing alt text in Markdown files?

The best way to fix missing alt text in Markdown files is to run an accessibility audit that detects missing image descriptions and applies remediation templates. This ensures documentation compliance by providing assistive technologies with necessary image context.

How do I validate anchor links and heading hierarchy in a README?

Validating anchor links and heading hierarchy in a README requires an accessibility audit that checks heading structures for proper sequence and verifies anchor link validity. This remediates navigation barriers and enforces inclusive documentation standards.

Does Markdown accessibility auditing cover emoji usage and table descriptions?

Markdown accessibility auditing does cover emoji usage and table descriptions, operating across 9 domains of compliance. It evaluates emoji handling to prevent screen reader confusion and checks table descriptions to ensure data relationships are clear.

Can I automate remediation for inaccessible diagrams in Markdown?

You can automate remediation for inaccessible diagrams in Markdown by utilizing an auditing tool that applies fix templates. The audit identifies diagram accessibility failures and suggests corrections to ensure visual information is available to assistive technologies.