All tools

Markdown Image Alt Text Auditor

Code

Scan a Markdown document's inline images and flag alt text accessibility smells: missing alt text, generic placeholder words, redundant prefixes, and alt text that's just the image's own filename

Paste a Markdown document and this scans every inline image for alt text that doesn't actually help a screen reader user: missing or empty alt text, a generic placeholder word used alone like "image" or "photo", a redundant "image of" or "photo of" prefix that screen readers already announce, and alt text that's really just the image's own filename copy-pasted in. It's built for a quick pre-publish pass over blog posts, READMEs, and docs rather than a full accessibility audit. Only inline Markdown image syntax is scanned, so reference-style images and raw HTML img tags slip through, and fenced code blocks are skipped so a code sample's own Markdown isn't flagged.

markdownaccessibilityalt-textlinta11y

How to use Markdown Image Alt Text Auditor

  • 1.Paste the Markdown document you want to audit into the input box.
  • 2.Review the list of images found and their alt text alongside the flagged issues below.
  • 3.Fix the flagged images: an empty alt is fine for a genuinely decorative image, but a generic or filename-based alt text should describe what the image actually shows.

Frequently asked questions

Does an empty alt text always count as a mistake?
No. An intentionally empty alt (![]()) is the correct way to mark a purely decorative image for screen readers, so this is flagged as worth reviewing rather than treated as a hard error.
Does this check reference-style images or HTML img tags?
No, only inline Markdown image syntax (![alt](src)) is scanned. Reference-style images (![alt][ref]) and raw HTML <img> tags aren't detected.
What counts as a 'generic' alt text?
A short list of placeholder words used alone, like "image", "photo", "picture", "screenshot", or "icon". Alt text that includes one of those words as part of a real description isn't flagged.
Is my document sent anywhere?
No, the scan runs entirely in your browser. Nothing is transmitted to a server or stored.

Use via API, SDK, or MCP

cURL# Free: 1,000 req/day · Pro: 10,000 req/day
curl -X POST https://api.utilix.tech/v1/tools/markdown-image-alt-text-auditor \
  -H "Authorization: Bearer utx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"markdown":"![](photo.png)\n![Photo of a mountain](mountain.jpg)\n"}'

Get an API key from your dashboard · Full API docs →

Related tools

Markdown Code Fence Language Tag ValidatorScan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tagCodeMarkdown Heading Hierarchy ValidatorValidate a Markdown document's heading structure: flag skipped levels, multiple H1s, empty headings, duplicate headings, and a document that doesn't start at H1CodeMarkdown Link Reference ExtractorExtract reference-style Markdown links ([text][ref]) and their [ref]: url definitions, flagging unresolved references and unused definitionsCode