---
id: rich-rst
version: "2.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# rich-rst — A beautiful reStructuredText renderer for rich

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install rich-rst
uv add rich-rst
poetry add rich-rst

## Description

<p align="center">
  <a href="https://github.com/wasi-master/rich-rst">
    <img src="https://raw.githubusercontent.com/wasi-master/rich-rst/main/logo.png" alt="Logo" width="200" height="200">
  </a>

  <h1 align="center">rich-rst</h2>
</p>

<p align="center">
   <a href="https://rich-rst.readthedocs.io/en/latest/?badge=latest"><img src="https://readthedocs.org/projects/rich-rst/badge/?version=latest" alt="Documentation Status"></a>
   <img src="https://img.shields.io/github/actions/workflow/status/wasi-master/rich-rst/tests.yaml?label=tests" alt="Tests Status">
   <img src="https://img.shields.io/github/actions/workflow/status/wasi-master/rich-rst/codeql.yml?label=codeql" alt="CodeQL Status">
   <img src="https://img.shields.io/codecov/c/github/wasi-master/rich-rst" alt="Codecov">
</p>

Render [reStructuredText](https://docutils.sourceforge.io/rst.html) with [Rich](https://rich.readthedocs.io/en/latest/). 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...

## AI interpretation — verify before relying

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.

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.

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