explaingit

whatwg/html

9,220HTMLAudience · developerComplexity · 3/5Setup · moderate

TLDR

This repository is the source of the official HTML Standard, the living specification that defines exactly how HTML works and how browsers must parse, render, and implement every HTML feature.

Mindmap

mindmap
  root((repo))
    What it is
      HTML specification
      Living document
      Browser implementor reference
    Topics covered
      Document structure
      Element behavior
      Parsing rules
    Features specified
      Canvas drawing
      Background workers
      Server-sent events
    Contributing
      File issues
      Submit pull requests
      Build spec locally
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Look up the exact specification for how a browser must handle a specific HTML element or parsing edge case when building a browser engine or HTML tool.

USE CASE 2

File an issue or propose a fix to the official HTML Standard when you find a discrepancy between the spec and real browser behavior.

USE CASE 3

Verify how HTML features like web workers, server-sent events, or canvas are officially defined before implementing them in a browser engine.

Tech stack

HTML

Getting it running

Difficulty · moderate Time to first run · 30min

Reading the spec requires no setup, building it locally requires following the contributing guide.

No license information was mentioned in the explanation.

In plain English

This repository is the source for the HTML Standard, which is the official specification for the HTML language used to build web pages. HTML is the markup language that browsers interpret to display text, images, links, forms, and other content on the web. The specification defines exactly how HTML is supposed to work, covering topics like the structure of documents, how different elements behave, how browsers should parse and render HTML, and how features like storage, background workers, server-sent events, and the canvas drawing surface operate. The HTML Standard is maintained by the WHATWG, a group of browser vendors and contributors who work together to keep web standards up to date. The specification is a living document, meaning it is continuously updated rather than released in discrete versions. The actual content of the specification lives in a single large source file in this repository. The repository is a place where issues can be filed and pull requests can be submitted to propose changes or fixes to the specification. Tests that verify browser implementations match the standard are kept separately in another project called web-platform-tests. Contributors who want to preview changes locally can build the HTML output from the source file using instructions in the contributing guidelines. The README for this repository is intentionally short because the specification itself, available at the linked website, is the main document. People looking to understand HTML the language would typically read tutorials or references, not this specification, which is written for browser implementors.

Copy-paste prompts

Prompt 1
I'm building a browser engine and need to understand exactly how the HTML parser handles malformed input. Summarize the key parsing rules from the HTML Standard for recovering from missing closing tags.
Prompt 2
The HTML Standard defines how the browser event loop works. Explain the relationship between the spec's event loop model and JavaScript's call stack and task queue.
Prompt 3
I want to propose a change to the HTML Standard to add a new attribute to an existing element. Walk me through writing a well-formed pull request for the whatwg/html repository.
Open on GitHub → Explain another repo

← whatwg on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.