Haddock to ADOC Converter
Processing entirely on your device — large files may take a moment.
Convert ADOC exactly like AsciiDoc: into Word, Markdown or HTML. If your files are still in Haddock format, this page is the shortcut: Haddock is the documentation markup of the Haskell ecosystem: -- comment blocks attached to functions, rendered into the API docs every Hackage package ships.
This converter runs entirely in your browser using WebAssembly — your files never leave your device, nothing is uploaded, and there are no watermarks, sign-ups or queues. Drop in several files at once to convert them as a batch.
How Haddock compares to ADOC
| Haddock | ADOC | |
|---|---|---|
| Structure | Comment markup (--, 'links', @mono@) | Plain-text markup (==, [source], |===) |
| Types / schema | UTF-8 text | UTF-8 text |
| Compatibility | Haskell, Hackage, Pandoc | Asciidoctor, Git docs, Pandoc |
| Best for | Haskell API documentation | Technical books and large doc sets |
How to convert Haddock to ADOC
- 1
Select your files
Select your Haddock file.
- 2
Convert instantly
The file is first converted to markdown (an interchange format that keeps headings, lists and paragraphs), then rebuilt into the target format.
- 3
Download results
Download the ADOC — structure preserved, heavy layout simplified.
About the Haddock format
Haddock is how Haskell explains itself: documentation comments in -- blocks, marked up with 'links' to identifiers, @monospace@ and /italics/, compiled into the API reference pages every package on Hackage publishes. The markup lives inside source files, but the format is its own small language.
Converted out of source comments, Haddock text becomes ordinary structured prose: Pandoc maps headings, code blocks and identifier links onto Markdown or HTML, so API knowledge can move into handbooks, wikis or static-site generators without retyping.
+Strengths
- ✓Documents live next to the code they describe
- ✓Identifier-aware linking across the API
- ✓Standard for the entire Haskell ecosystem
!Limitations
- −Meaningful only inside Haskell projects
- −Small grammar, few writers outside Haddock itself
- −Embedded in comments — needs extraction first
About the ADOC format
AsciiDoc is what happens when lightweight markup grows up. Where Markdown stops at bold and lists, AsciiDoc carries title pages, multi-level sections, callouts, admonitions, xrefs and real table syntax — enough to author entire technical books without leaving plain text. The Git and Linux-kernel documentation ecosystems standardized on it, rendered through Asciidoctor.
The format's weakness is tooling gravity: AsciiDoc converters outside the Asciidoctor/Ruby world are scarce, which is exactly where Pandoc fills the gap. Converting to Word hands manuscripts to editors who live in Office; converting to Markdown feeds modern docs sites. The section structure and tables survive the trip.
+Strengths
- ✓Book-grade structure: sections, callouts, admonitions, xrefs
- ✓Powering Git and Linux kernel docs — battle-tested at scale
- ✓Stays readable as plain text
!Limitations
- −Heavier syntax than Markdown for casual notes
- −Converter ecosystem concentrated in Asciidoctor tooling
- −Multiple dialects (legacy asciidoc vs asciidoctor)
Why convert Haddock to ADOC?
Converting makes sense where the strengths of ADOC meet what Haddock cannot give you. Book-grade structure: sections, callouts, admonitions, xrefs Meanwhile Meaningful only inside Haskell projects One pass through the converter above puts your file on the right side of that trade-off.
Frequently asked questions
Is this Haddock to ADOC converter really free?
Yes — completely free, with no sign-up, no watermark and no daily conversion limits. The site is supported by advertising.
Are my files uploaded to a server?
No. The conversion runs entirely inside your browser using WebAssembly, so your files never leave your device — that is what makes it instant and private.
Does it work on Windows, Mac, iPhone and Android?
Yes. Anything with a modern browser works: Windows, macOS, Linux, Android and iOS. No software installation is required.
Is there a file size limit for Haddock to ADOC?
The only limit is your device's memory, since nothing is uploaded. Files up to a few hundred megabytes work fine on a modern desktop browser; very large files simply take a little longer.
Does the conversion work offline?
Yes. Once the page has loaded, the conversion itself runs entirely inside your browser — you can even disconnect and keep converting. No file ever touches a server.
Will the layout of my Haddock file be preserved exactly?
This converter renders your Haddock content into ADOC with pages, proportions and images kept as close to the original as the target format allows. Use the preview before downloading to confirm it looks the way you expect.