Haddock es el sistema de marcado de documentación del ecosistema Haskell: -- bloques de comentarios adjuntos a funciones, que se renderizan en la documentación de la API que acompaña a cada paquete de Hackage.
Uso típico: Convertir los comentarios de Haddock al trasladar la documentación de Haskell a manuales en Markdown o HTML.
Sobre el formato Haddock
Haddock es cómo Haskell se explica a sí mismo: comentarios de documentación en bloques --, marcados con 'enlaces' a identificadores, @monoespaciado@ y /cursiva/, compilados en las páginas de referencia de la API que cada paquete en Hackage publica. El marcado vive dentro de los archivos fuente, pero el formato es su propio pequeño lenguaje.
Convertido a partir de los comentarios de origen, el texto de Haddock se convierte en prosa estructurada ordinaria: Pandoc mapea encabezados, bloques de código y enlaces de identificadores a Markdown o HTML, para que el conocimiento de la API pueda trasladarse a manuales, wikis o generadores de sitios estáticos sin tener que reescribirlo.
Ventajas
- ✓ Los documentos viven junto al código que describen
- ✓ Vinculación consciente de identificadores a través de la API
- ✓ Estándar para todo el ecosistema de Haskell
Limitaciones
- ✗ Significativo solo dentro de proyectos de Haskell
- ✗ Gramática pequeña, pocos escritores fuera de Haddock mismo
- ✗ Incrustado en comentarios — necesita extracción primero
- Estructura
- Marcado de comentarios (--, 'enlaces', @mono@)
- Tipos / esquema
- Texto UTF-8
- Compatibilidad
- Haskell, Hackage, Pandoc
- Ideal para
- Documentación de la API de Haskell
Convertir Haddock a…
6 direcciones directas más 1 flujos de trabajo, ordenadas A–Z; 🔥 marca los destinos populares.
Flujos multi-motor
Preguntas frecuentes
¿Qué es un archivo Haddock?
Haddock es el sistema de marcado de documentación del ecosistema Haskell: -- bloques de comentarios adjuntos a funciones, que se renderizan en la documentación de la API que acompaña a cada paquete de Hackage.
¿Cómo convierto archivos Haddock en línea?
Elige un formato de destino en la lista «Convertir Haddock a…» de abajo, suelta tu archivo y pulsa convertir. Todo ocurre en tu navegador: sin instalaciones, sin subidas, sin marcas de agua y sin límites.
¿Es seguro convertir archivos Haddock aquí?
Sí. Todas las conversiones las realiza tu propio dispositivo dentro del navegador: los archivos nunca salen hacia un servidor y la página sigue funcionando incluso sin conexión.
¿A qué formatos puede convertirse Haddock?
Esta página lista las 7 direcciones entre documentos, imágenes, audio, vídeo, hojas de cálculo y archivos: cada una es su propia página de conversor gratuito.