---
id: tree-sitter-html
version: "0.23.2"
license: MIT
license_treatment: permissive
maintenance: aging
---

# tree-sitter-html — HTML grammar for tree-sitter

License: permissive · Maintenance: aging · Downloads: 2.2M/mo

## What it is and what it does

tree-sitter-html is a language grammar for the tree-sitter incremental parser, specifically targeting HTML. It translates HTML source code into a concrete syntax tree that can be traversed and analyzed programmatically. The package is a compiled extension (available as prebuilt wheels for multiple platforms) that integrates with the tree-sitter ecosystem to enable fast, incremental parsing of HTML documents.

Developers use this package when they need to parse HTML programmatically—extracting structure, analyzing document trees, or building tools that reason about HTML syntax. It's particularly useful for code editors, linters, static analysis tools, and any application that needs to understand HTML structure. The grammar is based on the HTML5 specification.

Use it for:

- Extract and analyze HTML document structure for web scraping or content extraction tasks.
- Build linting or validation tools that check HTML syntax and structure.
- Implement syntax highlighting or code navigation in HTML editors.
- Generate abstract syntax trees for HTML transformation or code generation pipelines.
- Analyze HTML templates or markup in static site generators or documentation tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides an HTML grammar for tree-sitter, enabling incremental parsing and syntax tree analysis of HTML documents.

Yes, if you need to parse HTML programmatically with tree-sitter. The package is permissively licensed (MIT), has no known vulnerabilities, and offers prebuilt wheels for common platforms. Install friction is moderate but manageable. Repository is active though aging (641 days since last release). Verify tree-sitter availability in your environment before installing.

## Install

pip install tree-sitter-html
uv add tree-sitter-html
poetry add tree-sitter-html

## Installing tree-sitter-html

Before you install: Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (x86_64, ARM, macOS, Linux, Windows). Last release was 641 days ago; repository is active but aging.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal attribution requirements—suitable for both open-source and commercial projects.

Quickstart:

pip install tree-sitter-html

import tree_sitter_html

Requires Python 3.9 or later; tree-sitter core library must be available in the environment.

Verify before relying:

- Whether tree-sitter Python bindings are automatically installed as a dependency or must be installed separately.
- Performance characteristics for parsing large or deeply nested HTML documents.
- Conformance level to HTML5 spec beyond the reference link provided.
- Exact usage patterns and API surface for integrating this grammar with tree-sitter.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: aging
- Downloads: 2.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

html parsing tree-sitter, incremental html parser, html syntax tree, tree-sitter grammar html, html ast generation, parse html documents, html language binding, parsing, syntax-tree, html

[View on SkillFed](https://skillfed.io/packages/tree-sitter-html) · [View on PyPI](https://pypi.org/project/tree-sitter-html/)