Convert RST to HTML

Turn RST files into HTML. A standalone page titled from the document title, keeping headings, lists, tables, code, admonitions, footnotes and links, with math written as MathML.

Converted in an isolated sandbox on our serversDeleted after 24 hours

Drop RST files on the dialor turn it to pick what to do

A standalone web page from your RST.Headings, lists, tables, code and links carry over into one HTML file.

  1. What you get

    One HTML page, titled from the document title. Headings, lists, tables, code, admonitions, footnotes and links are kept as structure in the page.

    Math is written as MathML.

  2. What changes or is dropped

    Directives that only Sphinx knows, such as toctree, keep just their text. Comments are dropped.

    Images stay as links to files that were not uploaded, so they do not appear in the page unless those files are reachable at the linked paths.

  3. Going the other way

    To turn a web page back into RST, use HTML to RST. For other RST targets, see every RST conversion.

  4. Slides

    Turn on Slides to write the HTML as a slide deck instead of a page. Each first-level heading gets a title slide, and each second-level heading starts a new slide.

    The deck is a reveal.js deck. It loads reveal.js from a CDN when you open it, so the file needs to load that from the web to show as slides.

RST and HTML.What each format is, and the options this conversion takes.

  1. 01 · slides

    Slides

    Writes a slide deck with a new slide at each heading. HTML becomes a deck that opens in a browser, and LaTeX becomes a Beamer presentation to compile.

The formats

From · RST

reStructuredText

reStructuredText, the markup of Python documentation and Sphinx.

Extensions
.rst
MIME type
text/x-rst
Kind
Text and data
To · HTML

HTML

The markup of web pages. Text, links and structure, usually with CSS and images alongside.

Extensions
.html .htm
MIME type
text/html
Kind
Text and data

In your code.The same RST to HTML conversion through the API, for your app or your agent.

terminal
$ cv convert report.rst report.html
$ cv convert report.rst report.html

Questions.What people ask about RST to HTML.

01OF 04

Yes. The page is titled from the title of your RST document.

Images stay as links to files that were not uploaded. They show only if those files are reachable at the linked paths.

Sphinx-only directives such as toctree keep just their text. The table of contents they would build is not made.

No. Comments in the RST are dropped from the HTML.

More conversions.Other ways in and out of RST and HTML.