Haddock Converter
FileFlip converts Haddock files into 61 other formats entirely inside your browser, using Pandoc, MuPDF and ImageMagick compiled to WebAssembly. The Haddock file is never uploaded to a server: it is read off your disk, converted on your own machine, and saved back by the browser. There is no file-size limit and no account to create.
How do I convert a Haddock file?#
- Drop your Haddock file onto the converter at the top of this page, or click it to pick one from your computer.
- Choose the format you want out of it. FileFlip downloads the engine that conversion needs, once, and your browser caches it.
- Conversion starts the moment you pick the format, and the result is yours to download. The work happens in this tab, so nothing is uploaded and nothing is queued.
Is it safe to convert Haddock files online?#
Yes, because nothing is uploaded. FileFlip converts Haddock 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 happens to a Haddock file#
FileFlip converts Haddock into 61 formats with Pandoc, MuPDF and ImageMagick, all of it inside the browser tab. Each conversion below names the engine it uses, what it downloads, and exactly what that conversion keeps or drops.
| Category | Documents |
|---|---|
| File extension | .haddock |
| FileFlip support | Read and written |
| Conversions available | 61 |
| Engines | Pandoc, MuPDF and ImageMagick |
| Downloaded to your browser | 65.8 MB on the first conversion, then cached |
What is a Haddock file?#
A Haddock file holds documentation written in Haddock markup, the comment syntax Haskell's own documentation generator reads out of source files to build a module's API reference.
Write Haddock markup directly in Haskell source comments so `cabal haddock` can generate the package's API documentation.
Convert Haddock markup to Markdown when the same text needs to appear in a README or a project website outside the generated API docs.
The Haddock file format reference covers the specification, the programs that open one, and what each conversion keeps or drops.
Haddock questions people ask#
What is a .haddock file?
A .haddock file holds text written in Haddock markup, the comment syntax Haskell's documentation generator reads. In practice this markup normally lives inside `-- |` and `-- ^` comments in a .hs source file rather than a standalone file, so a .haddock file usually appears when that text has been extracted or converted on its own.
How do I generate documentation from Haddock comments?
Running `cabal haddock` or `stack haddock` in a Haskell project reads the Haddock comments in its source files and builds an HTML API reference, the same kind of page Hackage hosts for every published package.
What's the difference between -- | and -- ^ in Haddock?
-- | attaches a Haddock doc comment to the declaration that follows it, while -- ^ attaches one to the declaration or argument just before it. The choice is about position: -- | documents forward, -- ^ documents backward.