markdown-img-alt-text

Add detailed alt text to image embeds in Markdown files.

69|11|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/richtabor/agent-skills --skill markdown-img-alt-text
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-img-alt-text
Source: https://github.com/richtabor/agent-skills/tree/main/skills/markdown-img-alt-text
Command: npx skills add https://github.com/richtabor/agent-skills --skill markdown-img-alt-text

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown images often lack descriptive alt text, making notes inaccessible and harder to search. This Skill automatically analyzes image embeds in Obsidian-style and standard Markdown formats, generates thorough descriptions, and updates embeds inline to enhance accessibility and understandability.

Core Features & Use Cases

  • Detect images missing alt text in Obsidian wiki-style ![[image]] and standard markdown embeds.
  • Read image content and generate detailed, context-rich alt text that describes layout, labels, colors, and actions where relevant.
  • Update embeds in place, preserving syntax while embedding the alt text for accessibility and searchability.
  • Use Case: Prepare notes and documentation for assistive technologies or improve inclusivity in your notes and READMEs.

Quick Start

Run a description pass on your Markdown notes to add detailed alt text to all image embeds.

Frequently Asked Questions about markdown-img-alt-text

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

FAQPage Schema
How do I add alt text to images in Markdown files?

To add alt text to images in Markdown files, this Skill analyzes image embeds, generates detailed descriptions, and updates the embed syntax in place to include the alt text for accessibility and searchability.

Can I automatically generate image descriptions for Obsidian wiki-style embeds?

Yes, you can automatically generate image descriptions for Obsidian wiki-style embeds. This Skill detects ![[image]] formats, reads the image content, and rewrites the embed to include thorough, context-rich alt text.

Does this work with both standard Markdown and Obsidian image formats?

This works with both standard Markdown and Obsidian image formats. It processes standard ![](path) syntax and Obsidian wiki-style ![[image]] embeds, preserving your original formatting while inserting the generated alt text.

What is the best way to improve accessibility in Markdown documentation?

The best way to improve accessibility in Markdown documentation is to add descriptive alt text to image embeds. This Skill analyzes layout, labels, colors, and actions in your images to compose thorough descriptions for assistive technologies.

How do I update missing alt text across multiple Markdown notes?

To update missing alt text across multiple Markdown notes, run a description pass with this Skill. It detects images lacking alt text, analyzes each image, and updates the embeds inline to enhance inclusivity and searchability.