# gjtorikian/html-proofer

Test your rendered HTML files to make sure they're accurate.

Repository: https://github.com/gjtorikian/html-proofer
Canonical: https://ross.abutalabs.com/products/html-proofer
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, link-checker, html
Last push: 2026-07-28T16:54:44+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 94, release rhythm 83, longevity 100
- inputs: {"age_days": 4935, "days_push": 36, "days_rel": 36, "gap_med": 81, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1646, forks 216 (observed 2026-08-28T04:05:16.276355+00:00)

## What it is
HTMLProofer is a Ruby tool that validates rendered HTML files, checking for broken internal and external links, missing image alt tags, invalid scripts, favicons, and OpenGraph metadata. It is designed for use in continuous integration pipelines and offers both a command-line program and a Ruby API.

## Use cases
- check my static site for broken links
- validate html output in ci
- find images missing alt tags
- verify external links are not dead
- test generated html files for errors
- check favicon and opengraph metadata validity

## When to choose
- you generate html output (e.g., a static site or documentation) and want automated quality checks
- you need reliable link and image validation in a ci pipeline
- you want standards-based html checks with low false positives

## When to avoid
- you need subjective checks like spell checking or indentation linting
- your project is not ruby-based and you prefer a non-ruby toolchain
- you need to validate html in a live browser with javascript rendering

## Facets
- artifact type: cli-tool
- maturity: active
- function: testing, e2e-testing, developer-tools, ci-cd
- domain: web-development, testing, developer-tools, documentation
- platform: ruby, cli, cross-platform
- tags: html-validation, link-checker, static-site, accessibility-checks, continuous-integration

## Member repositories
- gjtorikian/html-proofer (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:16.276355+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:45:23.131889+00:00, confidence not recorded.
  - readme: https://github.com/gjtorikian/html-proofer (fetched 2026-08-28T04:05:16.276355+00:00, sha 148c4911780e)
- Data as of 2026-08-30T08:39:29.467469+00:00.