# kristoff-it/superhtml

HTML Validator, Formatter, LSP, and Templating Language Library

Repository: https://github.com/kristoff-it/superhtml
Canonical: https://ross.abutalabs.com/products/superhtml
Language: Zig
License: MIT
License Family: permissive
Topics: language-server, language-server-protocol, lsp, lsp-server, templating-engine, zig-package, html, validator
Last push: 2026-08-10T22:33:01+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 87, longevity 57
- inputs: {"age_days": 803, "days_push": 23, "days_rel": 85, "gap_med": 29.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1363, forks 73 (observed 2026-08-28T04:04:30.400407+00:00)

## What it is
SuperHTML is a CLI tool and language server written in Zig that validates, autoformats, and provides LSP features for HTML5 documents. It implements full WHATWG spec validation including element nesting and attribute values, and doubles as a templating language library.

## Use cases
- validate html files for syntax and nesting errors
- autoformat html documents on save
- run html formatting checks in ci
- get html language server support in vscode or neovim
- lint html5 documents against the whatwg spec
- format html with attribute alignment control

## When to choose
- you need strict, spec-complete HTML5 validation that other linters miss
- you want a fast standalone formatter and LSP without a node runtime
- you want to enforce normalized HTML in CI like gofmt does for Go

## When to avoid
- your HTML contains templating syntax like Jinja2, Angular, or Mustache and you need full validation (only syntax-only mode works)
- you need HTML4 or legacy doctype support
- you need CSS or JavaScript linting alongside HTML

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, formatter, templating, parser, developer-tools
- domain: web-development, frontend, developer-tools, documentation
- platform: windows, cli, editor-plugin, wasm
- tags: html-validator, html-formatter, language-server, lsp, html5, whatwg, vscode-extension, neovim, zig, command-line, linux, macos

## Member repositories
- kristoff-it/superhtml (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.400407+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-30T04:41:25.288722+00:00, confidence not recorded.
  - readme: https://github.com/kristoff-it/superhtml (fetched 2026-08-28T04:04:30.400407+00:00, sha a0214d8c6540)
- Data as of 2026-08-30T08:39:29.467469+00:00.