RST to HTML Converter - Python Documentation Tool

Convert reStructuredText to HTML with directives, roles, and code highlighting. Perfect for Python docs, Sphinx projects, technical writing.

Note: First conversion initializes Pandoc WebAssembly (~55MB). Subsequent conversions are instant.

Drop RST file here or click to browse

Accepts .rst, .txt files

reStructuredText Input

Enter RST to see preview

Common RST Syntax

RST Syntax	Description	HTML Result
`bold`	Strong emphasis	bold
`italic`	Emphasis	italic
``code``	Inline literal	`code`
`Title ======`	Section heading	<h1>Title</h1>
`Subtitle --------`	Subsection	<h2>Subtitle</h2>
`.. note::`	Note directive	Highlighted note box
`.. warning::`	Warning directive	Highlighted warning box
`.. code-block:: python`	Code block with language	<pre><code class="python">
:ref:`label`	Role (cross-reference)	Inline semantic markup
`link <url>`_	Hyperlink	<a href="url">link</a>

Copied to clipboard

Markdown to LaTeX Converter for Academic…

Creole to HTML Converter - WikiCreole Mi…

HTML to Markdown Converter - Transform H…

Textile to HTML Converter - Redmine Migr…

Org Mode to LaTeX - Academic Papers from…

View all Markup converters →

Frequently Asked Questions

reStructuredText is a plain text markup language widely used in Python documentation, Sphinx documentation systems, and technical writing. It offers powerful features like directives, roles, and semantic markup for creating structured documents.

Common directives including .. note::, .. warning::, .. code-block::, .. image::, .. figure::, .. contents::, .. include::, and more. Sphinx-specific directives may have limited support in the browser-based converter.

Standard roles (:emphasis:, :strong:, :literal:, :code:) are fully supported. Sphinx-specific roles (:doc:, :ref:, :mod:, :func:) are preserved but may not generate working links without the full Sphinx context.

Yes, for individual RST files. The converter handles most RST syntax and common Sphinx directives. However, cross-references between documents and Sphinx extensions require the full Sphinx build environment.

Code blocks (.. code-block:: python) are converted to HTML

 elements with appropriate language classes, ready for syntax highlighting libraries like Prism or highlight.js.

Yes. All conversion happens locally in your browser using WebAssembly. Your RST documents never leave your device and are not uploaded to any server.

RST offers more semantic markup, extensibility through directives/roles, better table support, and is the standard for Python documentation. It's more powerful for technical documentation than Markdown.

Yes. You can paste RST text directly or upload .rst files from your computer. The tool reads the file content and converts it to HTML instantly.

RST supports grid tables (ASCII art boxes), simple tables (space-separated columns), and list tables (directive-based). All formats are converted to HTML table elements with proper structure.

RST uses **bold** for strong emphasis, *italic* for emphasis, ``inline code`` for literals, and various roles for semantic markup. All are converted to appropriate HTML tags (, , ).

Common RST Syntax

Related Tools