Convertidor de Haddock a AsciiDoc
Todo se procesa en tu dispositivo; los archivos grandes pueden tardar un poco.
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. Convierte AsciiDoc cuando los documentos necesitan transferirse a Word, flujos de trabajo de Markdown o sitios HTML sin perder la estructura.
Como toda la conversión ocurre en tu dispositivo, es instantánea, ilimitada y de verdad privada: sin cuentas, sin marcas de agua y sin archivos en ningún servidor. Varios archivos se convierten de una sola vez.
Comparación de Haddock con AsciiDoc
| Haddock | AsciiDoc | |
|---|---|---|
| Estructura | Marcado de comentarios (--, 'enlaces', @mono@) | Marcado de texto plano (==, [source], |===) |
| Tipos / esquema | Texto UTF-8 | Texto UTF-8 |
| Compatibilidad | Haskell, Hackage, Pandoc | Asciidoctor, documentación de Git, Pandoc |
| Ideal para | Documentación de la API de Haskell | Libros técnicos y grandes conjuntos de documentos |
Cómo convertir Haddock a AsciiDoc
- 1
Selecciona tus archivos
Selecciona tu archivo Haddock.
- 2
Convierte al instante
El archivo se convierte primero a markdown (un formato de intercambio que conserva encabezados, listas y párrafos) y luego se reconstruye en el formato de destino.
- 3
Descarga los resultados
Descarga el AsciiDoc: estructura conservada, maquetación pesada simplificada.
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
Sobre el formato AsciiDoc
AsciiDoc es lo que sucede cuando el marcado ligero crece. Donde Markdown se detiene en negritas y listas, AsciiDoc incluye portadas, secciones multinivel, llamadas de atención, advertencias, referencias cruzadas y sintaxis de tabla real, lo suficiente para escribir libros técnicos completos sin salir del texto plano. Los ecosistemas de documentación de Git y del kernel de Linux se estandarizaron en él, renderizados a través de Asciidoctor.
La debilidad del formato es la gravedad de las herramientas: los convertidores de AsciiDoc fuera del mundo Asciidoctor/Ruby son escasos, que es exactamente donde Pandoc llena el vacío. Convertir a Word entrega los manuscritos a editores que viven en Office; convertir a Markdown alimenta sitios de documentación modernos. La estructura de secciones y las tablas sobreviven al viaje.
+Ventajas
- ✓Estructura del libro por niveles: secciones, llamados de atención, advertencias, referencias cruzadas
- ✓Impulsando la documentación de Git y del kernel de Linux — probada en batalla a gran escala
- ✓Permanece legible como texto plano
!Limitaciones
- −Sintaxis más pesada que Markdown para notas informales
- −Ecosistema de conversores concentrado en las herramientas de Asciidoctor
- −Múltiples dialectos (asciidoc heredado vs asciidoctor)
¿Por qué convertir Haddock a AsciiDoc?
Hay una razón concreta para esta conversión: Significativo solo dentro de proyectos de Haskell AsciiDoc lo evita — Estructura del libro por niveles: secciones, llamados de atención, advertencias, referencias cruzadas Si es tu caso, la herramienta de arriba lo resuelve en segundos, todo en tu propio dispositivo.
Preguntas frecuentes
¿Este conversor de Haddock a AsciiDoc es realmente gratis?
Sí: completamente gratis, sin registro, sin marcas de agua y sin límites diarios de conversión. El sitio se mantiene con publicidad.
¿Mis archivos se suben a algún servidor?
No. La conversión se ejecuta por completo dentro de tu navegador con WebAssembly, así que tus archivos nunca salen de tu dispositivo: por eso es instantánea y privada.
¿Funciona en Windows, Mac, iPhone y Android?
Sí. Funciona en cualquier dispositivo con un navegador moderno: Windows, macOS, Linux, Android e iOS. No hay que instalar ningún software.
¿Hay límite de tamaño de archivo para Haddock a AsciiDoc?
El único límite es la memoria de tu dispositivo, ya que no se sube nada. Los archivos de hasta unos cientos de megabytes funcionan bien en un navegador de escritorio moderno; los muy grandes simplemente tardan un poco más.
¿Puedo editar el resultado AsciiDoc después?
Depende del destino: AsciiDoc está diseñado para su función, y este conversor reproduce su contenido fielmente en lugar de inventar una estructura editable. Para reeditar mucho, parte de un formato pensado para edición y exporta la versión final aquí.
¿La maquetación de mi archivo Haddock se conservará exactamente?
Este conversor renderiza tu contenido Haddock en AsciiDoc manteniendo páginas, proporciones e imágenes tan fielmente como lo permite el formato de destino. Usa la vista previa antes de descargar para confirmar que se ve como esperas.