# syntax-tree/unist

Universal Syntax Tree used by @unifiedjs

Repository: https://github.com/syntax-tree/unist
Canonical: https://ross.abutalabs.com/products/unist
Homepage: https://unifiedjs.com
License Family: other
Topics: syntax-tree, ast, cst, unist-nodes, unist-files, unist-utilities, remarks, unist, mdast, hast, xast, nlcst
Last push: 2026-06-01T16:10:53+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 85, release rhythm 8, longevity 100
- inputs: {"age_days": 4051, "days_push": 93, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1010, forks 28 (observed 2026-08-28T04:03:12.920849+00:00)

## What it is
unist is a specification for universal syntax trees that can represent abstract and concrete syntax trees for code, markup, and natural language, expressible in JSON. It underpins the unified ecosystem (remark, rehype, retext) and is implemented by specifications like mdast, hast, nlcst, and xast, with a large ecosystem of JavaScript utilities.

## Use cases
- work with markdown, html, or natural language as syntax trees
- define a custom syntax tree format compatible with unified
- traverse and transform document trees in javascript
- share tree node types across remark and rehype plugins
- serialize structured content to and from json

## When to choose
- building unified, remark, rehype, or retext plugins
- you need a common tree format across multiple content languages
- writing utilities that operate on any unified syntax tree

## When to avoid
- you need a parser or compiler itself - unist is only a specification
- working outside the unified ecosystem with no tree interoperability needs
- you need concrete runtime code - use the unist-util-* packages instead

## Facets
- artifact type: library
- maturity: stable
- function: parser, serialization, type-system, developer-tools
- domain: parsers, web-development, documentation, developer-tools
- platform: cross-platform
- tags: ast, syntax-tree, unist, unified-ecosystem, specification, mdast, hast, nlcst, xast, tree-traversal, typescript-types, natural-language-processing, nodejs, javascript

## Member repositories
- syntax-tree/unist (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:12.920849+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-30T07:11:58.527711+00:00, confidence not recorded.
  - readme: https://github.com/syntax-tree/unist (fetched 2026-08-28T04:03:12.920849+00:00, sha dcc05a156ac3)
  - homepage: https://unifiedjs.com (fetched 2026-08-29T13:12:18.071861+00:00, sha 0359e5fdf9c6)
  - site_page: https://unifiedjs.com/explore/release (fetched 2026-08-29T13:12:18.074636+00:00, sha 34c5baf82537)
- Data as of 2026-08-30T08:39:29.467469+00:00.
