vercel

streamdown: Render Streaming Markdown in React

Streamdown is a React Markdown renderer designed for AI-generated text as it streams, handling incomplete Markdown that can disrupt ordinary rendering. It replaces react-markdown and uses remend to improve parsing of unterminated blocks.

ActiveTypeScriptReactLibraryAI
Stars
5.7k
Forks
319
Stars, last 30 days
+59
Last commit
1 day ago
Contributors
100+

Our take

Activeregular commits and releases

Health score

69/100

How it is scored
Activity
85
Community
71
Issues
68
Pull requests
52

+59 stars in the last 30 days

  • Releases more often than 86% of the projects we track
  • Merges more pull requests than 82% of the projects we track
  • More contributors than 78% of the projects we track

Streamdown is an actively maintained, specialized React renderer with frequent releases and quick issue and pull-request handling, making it a promising fit for streaming AI interfaces, though its license status and lack of reported tests deserve review.

Good fit if

  • You need Markdown to render cleanly while AI-generated text is still arriving in a React UI.
  • You want optional support for code highlighting, math, Mermaid, or CJK content.
  • Your project can use Node.js 20 or newer, and you are comfortable checking the repository’s license details before adoption.

Look elsewhere if

  • You need a renderer for a non-React application.
  • You need a clearly identified license before evaluating or distributing a dependency, since the provided repository data lists the license as NOASSERTION.
  • Your adoption criteria require tests to be reported in the supplied project requirements data.
All health signals
Last commit2026-10-29 (1 day ago)
Commits, last 90 days100+
Releases, last 12 months47 (latest streamdown@2.7.1, 2026-10-19)
Contributors100+ (top contributor: 67% of commits)
Issues closed, last 90 days20+ (typically closed in 3 days)
Pull requests merged, last 90 days72 (typically merged in 2 days)
Project age15 months

Checked on 2026-10-31 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

5,780

Forks

342

Change since Nov 21, 2026: 0 stars·+1 forks

Overview

Streamdown is a React Markdown renderer and drop-in replacement for react-markdown, built for displaying AI-generated text while it is still streaming. Ordinary Markdown rendering can struggle with unfinished syntax; Streamdown uses remend to handle incomplete and unterminated blocks more gracefully.

It is intended for React applications that need readable, formatted streaming responses, including applications using the AI SDK. It can also be installed as a standalone package, with optional plugins for code highlighting, math, Mermaid diagrams, and CJK text.

Key Features

  • Renders incomplete Markdown during streaming, rather than waiting for a complete document.
  • Supports GitHub Flavored Markdown features such as tables, task lists, and strikethrough.
  • Offers optional plugins for Shiki code highlighting, KaTeX math, Mermaid diagrams, and CJK text.
  • Uses rehype-harden for security-focused rendering.
  • Supports custom component overrides and a fallback component for tags without built-in renderers.
  • Includes memoized rendering and an animation option for streaming updates.

Use Cases

  • A team building an AI chat interface can render each text response as it arrives instead of displaying raw Markdown until generation finishes.
  • Developers using the AI SDK can add formatted assistant messages to a React application.
  • A documentation or analysis interface can display streamed tables, code, equations, or diagrams using the corresponding optional plugins.
  • A React app that already uses react-markdown can consider Streamdown when incomplete streaming output is a problem.

What you need

Detected in the repository

  • Node.js >=20 (from package.json)
  • Automated checks on GitHub Actions

Getting Started

Install the package:

npm i streamdown

See the README and documentation for setup details, Tailwind configuration, and usage examples.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • x: Ant Design X is a broader React UI suite with streaming Markdown among its conversation components, while Streamdown focuses on rendering incomplete Markdown.
ProjectLanguageLicenseStarsStatus
streamdownTypeScript–5.7kActive
xTypeScript–4.8kActive

Considerations

The supplied health data describes the project as active: it has recent commits, regular releases, and ongoing merged pull requests, with a short median time to close issues and merge pull requests. Contributor data is not marked as concentrated, so the project does not appear to depend mostly on one person. These indicators show active maintenance, but do not establish long-term support guarantees.

The supplied requirements specify Node.js 20 or newer and do not report tests. The README also calls for Tailwind source configuration and CSS design tokens, and some capabilities require separately installed plugins. The repository data does not identify a license, so teams should verify licensing terms before relying on or distributing the package.

Found this useful?

Share it with someone who would like streamdown.

Comparisons