Convert DOCBOOK to RST

Turn DOCBOOK files into reStructuredText. A reStructuredText document with headings, lists, tables, links and footnotes.

Converted in an isolated sandbox on our serversDeleted after 24 hours

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

DocBook turned into reStructuredText.Headings, lists, tables, links and footnotes carry over into one RST file.

  1. What you get

    One reStructuredText document. It has headings, lists, tables, links and footnotes. DocBook is the structured XML format of technical books and manuals, and RST is the markup of Python documentation and Sphinx.

    The conversion has no options. You give it a DocBook file with the extension dbk or docbook, and you get one RST file back.

  2. What changes

    Entities declared in the file are expanded. The text of each entity appears in the output where the entity was used.

    Images stay as links. The picture itself is not placed in the RST file, only the link to it.

  3. Names run together

    When a first name and a surname are written in DocBook without a space between their tags, they run together in the output. The two names come out as one word.

  4. Going the other way

    To turn RST back into DocBook, use RST to DOCBOOK.

DOCBOOK and RST.What each format is.

The formats

From · DOCBOOK

DocBook

DocBook XML, the structured format of technical books and manuals.

Extensions
.dbk .docbook
MIME type
application/docbook+xml
Kind
Text and data
To · RST

reStructuredText

reStructuredText, the markup of Python documentation and Sphinx.

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

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

terminal
$ cv convert report.dbk report.rst
$ cv convert report.dbk report.rst

Questions.What people ask about DOCBOOK to RST.

01OF 04

Yes. Tables and footnotes are part of the RST document, along with headings, lists and links.

Entities declared in the file are expanded. Their text appears in the RST output.

No. Images stay as links, so the RST file points to them.

They are written without a space between their tags in the DocBook source. In that case they run together in the output.

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