Skip to content

DocBook to ICML Converter

FileFlip converts DocBook to ICML entirely inside your browser, using Pandoc 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.

Convert DBK to

How do I convert a DocBook file to ICML?#

  1. Drop your DocBook 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.
  2. Leave the target set to ICML and the conversion starts on its own. FileFlip downloads 65.8 MB of WebAssembly the first time and nothing after that, then runs Pandoc on your own machine.
  3. Save the ICML file. Your browser writes it straight to your downloads folder, because there was never a server holding it.

Does converting DocBook to ICML lose quality?#

Not in the sense of pixels or samples. Converting DocBook to ICML rebuilds the file in ICML's own model rather than re-encoding it, so everything ICML 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 DocBook files online?#

Yes, because nothing is uploaded. FileFlip converts DocBook 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 DocBook to ICML actually does to the file#

Converting DocBook to ICML runs on Pandoc, 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 page layout.

EnginePandoc
Conversion pathOne step: DocBook → ICML
Downloaded to your browser65.8 MB, once, then cached by your browser
QualityRebuilt in the target's model
You get backOne file
Where it runsIn a background worker, so the page stays responsive

What survives the conversion

What is in the fileThis conversionWhy
Selectable textKeptCarried through into the converted file.
Page layoutKeptCarried through into the converted file.

What is a DocBook file?#

A DBK file is a DocBook document, XML markup that describes a technical document's structure and meaning, such as chapters, sections, and code listings, rather than its visual layout, so one source can be styled into a printed book or a web page.

Write in DocBook when producing technical documentation that has to publish to multiple outputs, such as print, web, and help, from one validated source.

Convert DocBook to another format when the reader only needs the finished document and doesn't need to maintain the structured XML source.

What is an ICML file?#

An ICML file is a single XML document holding one InDesign story's text and its paragraph and character style names, with no page geometry, meant to be opened in Adobe InCopy or imported into an existing InDesign layout rather than viewed on its own.

Use ICML to move styled text into an InDesign layout from a source that can generate structured XML, keeping paragraph and character styles intact instead of retyping the copy.

Convert content out of ICML once it leaves the InDesign workflow, since almost nothing outside Adobe's own applications reads it.

DocBook to ICML questions people ask#

What opens a .dbk file?

A .dbk file is DocBook XML, which is plain text, so any text or XML editor opens it, though tools like Oxygen XML Editor or Visual Studio Code with an XML extension add validation and structure awareness. Converting it to HTML or PDF is the usual way to read it as a finished document.

Why is DocBook so much more verbose than Markdown?

DocBook tags every structural piece of a document explicitly, such as marking a term as a <function> or a note as a <warning>, instead of relying on plain punctuation the way Markdown does. That verbosity is deliberate: it's what lets the same source publish correctly to print, web, and help formats without rewriting it for each one.

Is DocBook still actively maintained?

DocBook is still usable and its tooling still works, but the OASIS technical committee that governed the specification closed in September 2024. Development now happens informally rather than through that standards body, which is typical of a format that has settled rather than one still evolving quickly.

What application opens an ICML file?

Adobe InDesign and Adobe InCopy are effectively the only applications that open ICML files, since the format exists specifically to move a story's styled text between the two. There is no independent viewer for it outside Adobe's publishing tools.