Skip to main content

scripts-fix-md045

#!/usr/bin/env python3 """​

title: "MD045: Images should have alternate text" component_type: script version: "1.0.0" audience: contributor status: stable summary: "Fixes MD045 markdownlint rule - adds alt text to images missing it" keywords: ['fix', 'md045'] tokens: ~500 created: 2025-12-22 updated: 2025-12-22 script_name: "fix-md045.py" language: python executable: true usage: "python3 scripts/fix-md045.py [options]" python_version: "3.10+" dependencies: [] modifies_files: false network_access: false requires_auth: false​

"""

MD045: Images should have alternate text

import re from pathlib import Path

def fix_md045(content): fixed = 0 def add_alt(match): nonlocal fixed fixed += 1 return f"Image"

content = re.sub(r'!\[\]\(([^)]+)\)', add_alt, content)
return content, fixed

def process_file(file_path, dry_run=False): try: with open(file_path, 'r', encoding='utf-8') as f: content = f.read() fixed_content, count = fix_md045(content) if count > 0 and not dry_run: with open(file_path, 'w', encoding='utf-8') as f: f.write(fixed_content) return count except Exception as e: print(f"Error: {e}") return 0

if name == 'main': import argparse parser = argparse.ArgumentParser(description='Fix MD045') parser.add_argument('paths', nargs='*', default=['.']) parser.add_argument('--dry-run', action='store_true') args = parser.parse_args()

total = 0
for path_str in args.paths:
    for md_file in Path(path_str).rglob('*.md'):
        count = process_file(md_file, args.dry_run)
        if count:
            print(f"{'[DRY RUN] ' if args.dry_run else ''}Fixed {count} issues in {md_file}")
            total += count
print(f"\nTotal: {total} issues fixed")