rich-rst

A beautiful reStructuredText renderer for rich

rich-rst Permissive license MIT Active ★ 20 v2.1.0 released 2026-07-05

Install

rich-rst on PyPI

pip

pip install rich-rst

uv

uv add rich-rst

poetry

poetry add rich-rst

Package facts

License	MIT (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	2 — rich, pygments
Maintenance	actively maintained — 39 days since the last release
Last repo commit	2026-07-18
First released	2021-09-06
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: rich_rst-2.1.0-py3-none-any.whl

Keywords: rich, rst, restructuredtext, terminal, docutils, renderer

Development Status :: 5 - Production/StableIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

About rich-rst

from the package's own PyPI description — quoted content, verbatim

Render reStructuredText with Rich. This package turns reST documents into Rich renderables so you can preview documentation, docstrings, and snippets directly in the terminal. Also includes a CLI.

Highlights

Supports all currently documented RST elements.
Handles common documentation features such as...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Renders reStructuredText documents as Rich-formatted terminal output, supporting headings, lists, tables, code blocks, and Sphinx roles for previewing documentation and docstrings directly in the terminal.

Low friction; pure Python wheel with only two runtime dependencies (rich and pygments). Actively maintained with a recent release 39 days ago and passing test/CodeQL workflows.

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Usage

pip install rich-rst

from rich import print
from rich_rst import RestructuredText

document = """Title\n=====\n\nThis is **bold** text."""
print(RestructuredText(document))

Verdict: A well-maintained, low-friction package for rendering reStructuredText in the terminal. MIT-licensed, actively developed, and backed by two stable dependencies. No known vulnerabilities and ranked in the top 1000 PyPI packages. Suitable for documentation preview workflows and CLI tools.

Needs verification

Whether Python version support is truly unspecified or if there is an undocumented minimum (classifiers suggest 3.8+)
Performance characteristics when rendering very large RST documents
Whether all Sphinx roles mentioned are fully compatible or if some have known limitations

restructuredtext terminal rendererrst to rich formattingdocstring preview cliterminal documentation viewersphinx rst renderercode block syntax highlighting terminalrst cli tool