Convert RST to MAN

Turn RST files into MAN. A man page in roff with the headings as sections; tables and links are simplified.

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 man page from your RST file.Headings become sections in roff. Tables and links are simplified.

  1. What you get

    One MAN file in troff, the markup Unix manual pages use. The headings of your RST document become the sections of the man page.

  2. What changes

    Tables and links are simplified. The man page does not keep them in their full RST form.

    Directives that only Sphinx knows, such as toctree, keep just their text. Their special behavior is not carried over.

  3. What is left behind

    Comments are dropped. They do not appear in the man page.

    Images stay as links. The picture itself is not placed in the file.

RST and MAN.What each format is.

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 · MAN

Man Page

Unix manual pages in troff.

Extensions
.man
MIME type
text/troff
Kind
Text and data

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

terminal
$ cv convert report.rst report.man
$ cv convert report.rst report.man

Questions.What people ask about RST to MAN.

01OF 04

Yes. The headings become sections in the man page.

It keeps just its text. Directives that only Sphinx knows are not carried over as directives.

No. Comments are dropped from the man page.

Yes. MAN to RST converts a man page to RST.

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