RST to CBZ Converter
FileFlip converts RST to CBZ entirely inside your browser, using Pandoc and MuPDF compiled to WebAssembly. The file is never uploaded to a server: it is read off your disk, converted on your own machine, and saved back by the browser. That means no file-size limit, no queue and no account.
How do I convert an RST file to CBZ?#
- Drop your RST file onto the converter at the top of this page, or click it to pick one from your computer. You can add as many as you like.
- Leave the target set to CBZ and the conversion starts on its own. FileFlip downloads 65.8 MB of WebAssembly the first time and nothing after that, then runs Pandoc and MuPDF on your own machine.
- Save the CBZ file. Your browser writes it straight to your downloads folder, because there was never a server holding it.
Does converting RST to CBZ lose quality?#
Not in the sense of pixels or samples. Converting RST to CBZ rebuilds the file in CBZ's own model rather than re-encoding it, so everything CBZ can represent comes through exactly and anything it cannot has to be dropped. Expect the words to come through exactly and the page breaks to move.
Is it safe to convert RST files online?#
Yes, because nothing is uploaded. FileFlip converts RST files inside the browser tab you already have open, using WebAssembly builds of the same engines a desktop converter would install. Your file is read from your own disk into the page's memory, and no request carrying it is ever made.
You do not have to take that on trust. Open your browser's network panel, run a conversion, and you will see the engine come down and your file go nowhere. There is no upload, no server-side copy, no retention window, and no account tied to what you converted.
How FileFlip works lists every engine, its version and its download size, and shows how to check for yourself that nothing leaves your machine.
What RST to CBZ actually does to the file#
Converting RST to CBZ runs on Pandoc and MuPDF, downloads 65.8 MB of WebAssembly the first time and nothing after that, rebuilds the file in the target's own model, keeps selectable text, and drops page layout.
| Engine | Pandoc and MuPDF |
|---|---|
| Conversion path | 2 steps: RST → HTML → CBZ |
| Downloaded to your browser | 65.8 MB, once, then cached by your browser |
| Quality | Rebuilt in the target's model |
| You get back | One file |
| Where it runs | In a background worker, so the page stays responsive |
What survives the conversion
| What is in the file | This conversion | Why |
|---|---|---|
| Selectable text | Kept | Carried through into the converted file. |
| Page layout | Dropped | The target format has nowhere to put it. |
Worth knowing before you start:
- reflowable input is laid out on a fixed 595x842pt page at 11pt before anything else happens
- the file passes through HTML on the way, so anything HTML cannot express does not survive
What is an RST file?#
An RST file holds reStructuredText, the markup David Goodger designed in 2001 for Python documentation, where directives and interpreted text roles extend the syntax with cross-references, footnotes and generated content that Markdown has no built-in equivalent for.
Write in reStructuredText for Python documentation or any Sphinx-built site that needs directives, cross-references and generated indexes.
Convert reStructuredText to Markdown when the destination lives outside the Sphinx or Python ecosystem, since most directives don't have a Markdown equivalent.
What is a CBZ file?#
A CBZ file is a ZIP archive of page images, usually JPEG or PNG, named so they sort into reading order, with nothing else defining it as a comic beyond that convention.
Use CBZ to distribute a scanned or digital comic as sequential page images that any comic reader opens without conversion.
Convert CBZ to PDF when a comic needs to move into software that expects a page-based document instead of a folder of images.
RST to CBZ questions people ask#
What is reStructuredText used for?
reStructuredText is the markup behind Python's own documentation and most Sphinx-built documentation sites, chosen because PEP 287 made it the standard format for Python docstrings. Its directive system lets a project define custom content types, which is why documentation with heavy cross-referencing tends to land on it over Markdown.
What's the difference between RST and Markdown?
reStructuredText defines directives and interpreted text roles as a formal extension mechanism, where Markdown relies on each implementation inventing its own extensions. RST is also more strictly specified, so a Docutils-conformant file parses the same way everywhere, at the cost of a more verbose syntax than Markdown's.
Can I convert RST to Markdown without losing anything?
Headings, paragraphs, lists and basic emphasis convert from reStructuredText to Markdown cleanly. Directives, most notably Sphinx-specific ones like toctree or code-block with language-aware highlighting, plus footnotes and substitution definitions, have no direct Markdown equivalent and either get dropped or flattened to plain text.
What is a CBZ file?
A CBZ file is a ZIP archive holding a comic's pages as individual image files, named so they sort into the right reading order. There is no page-layout data or text encoding involved, which is the entire format: a comic reader just opens the ZIP and displays the images in sequence.