# vercel/streamdown

A drop-in replacement for react-markdown, designed for AI-powered streaming.

Repository: https://github.com/vercel/streamdown
Canonical: https://ross.abutalabs.com/products/streamdown
Homepage: https://streamdown.ai
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: ai, markdown, streaming
Last push: 2026-08-26T14:08:06+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 27
- inputs: {"age_days": 384, "days_push": 7, "days_rel": 9, "gap_med": 0, "n_releases_24m": 50}
- 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 5563, forks 290 (observed 2026-08-28T04:09:22.373312+00:00)

## What it is
Streamdown is a React component library that serves as a drop-in replacement for react-markdown, purpose-built for rendering Markdown streamed token-by-token from AI models. It handles incomplete Markdown syntax gracefully and ships with built-in typography, GFM, syntax highlighting, math, Mermaid diagrams, streaming carets, animations, and security hardening.

## Use cases
- render streaming markdown from an LLM chat response
- replace react-markdown in an AI chat app
- display incomplete markdown while tokens are still streaming
- render markdown with syntax highlighting, math, and mermaid diagrams in React
- add a typing caret and per-word animation to streaming AI text
- safely render AI-generated markdown with link and image hardening
- support CJK punctuation in streamed markdown

## When to choose
- you are building an AI chat or streaming interface in React that renders markdown
- you want a react-markdown replacement with built-in GFM, code highlighting, math, and mermaid
- you need graceful rendering of unterminated markdown blocks during streaming
- you want security hardening (sanitization, link safety) for AI-generated content out of the box

## When to avoid
- you render static, non-streaming markdown and don't need streaming-specific features
- your project doesn't use React or Tailwind CSS
- you need a framework-agnostic or server-side-only markdown renderer
- you require a permissively-licensed dependency and cannot accept the Apache-2.0/npm terms

## Facets
- artifact type: library
- maturity: active
- function: markdown, parser, ui-components, security, animation
- domain: frontend, web-development, large-language-models, chatbots, developer-tools
- platform: cross-platform
- tags: react, streaming, ai, react-markdown, gfm, syntax-highlighting, tailwind, chat-ui, nodejs, web-server

## Member repositories
- vercel/streamdown (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:22.373312+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-29T17:55:37.780061+00:00, confidence not recorded.
  - readme: https://github.com/vercel/streamdown (fetched 2026-08-28T04:09:22.373312+00:00, sha 5c5141cd02b1)
  - homepage: https://streamdown.ai (fetched 2026-08-29T08:51:09.141893+00:00, sha 316000f814f2)
  - site_page: https://streamdown.ai/en/docs (fetched 2026-08-29T08:51:09.144747+00:00, sha ef894227f97a)
  - site_page: https://streamdown.ai/en/docs/animation (fetched 2026-08-29T08:51:09.146511+00:00, sha 44d723f37f4d)
  - site_page: https://streamdown.ai/en/docs/plugins (fetched 2026-08-29T08:51:09.148368+00:00, sha 24613d9183ff)
  - site_page: https://streamdown.ai/docs (fetched 2026-08-29T08:51:09.150040+00:00, sha 4e8968c97a54)
  - site_page: https://streamdown.ai/docs/getting-started (fetched 2026-08-29T08:51:09.151631+00:00, sha 5c11f7c4886f)
  - site_page: https://streamdown.ai/docs/usage (fetched 2026-08-29T08:51:09.153501+00:00, sha 3ebdba0b9711)
  - site_page: https://streamdown.ai/docs/migrate (fetched 2026-08-29T08:51:09.155390+00:00, sha 5cbbdde72ce4)
  - site_page: https://streamdown.ai/docs/faq (fetched 2026-08-29T08:51:09.157268+00:00, sha fd56755dcae5)
- Data as of 2026-08-30T08:39:29.467469+00:00.