# markdown.dkh: convertir Markdown a HTML `markdown.dkh` convierte texto Markdown en HTML con Markdig. No tiene DLL propia: es una envoltura en DKL de `Markdig.dll`, que **se instala aparte** del motor: vea [Bibliotecas de terceros](/es/devkron/2.0/bibliotecas/terceros/). ## Cuándo usarla - Mostrar en una página documentación, avisos o notas de versión escritos en Markdown. - Permitir que el usuario dé formato a comentarios, descripciones de productos o respuestas de soporte. - Presentar la respuesta de un agente de IA, que casi siempre viene en Markdown. ## Instalación Copie junto a `dkl` (o a la carpeta del servidor FastCGI) `markdown.dkh` y `Markdig.dll` (Markdig 1.5.0). ```dkl #include "markdown.dkh" ``` ## Funciones | Función | Devuelve | Descripción | |---|---|---| | `md.html(texto)` | cadena | HTML con extensiones avanzadas; el HTML crudo del texto pasa tal cual | | `md.html_safe(texto)` | cadena | Igual, pero el HTML crudo se escapa y se muestra como texto | | `md2html(texto)` | cadena | Igual que `md.html` (nombre de `markdig.dkl` de `dkl-web`, por compatibilidad) | Las tres activan las **extensiones avanzadas** de Markdig: tablas (con alineación `---:`), listas de tareas (`- [x]`), notas al pie (`[^1]`), tachado, enlaces automáticos, listas de definición, atributos `{.clase}`, abreviaturas, citas y figuras, matemáticas, diagramas y encabezados con `id` (`# Título con acentos` → `id="titulo-con-acentos"`). Con texto vacío devuelven `""`. ### md.html(texto) Úsela con texto **de confianza** (escrito por su equipo, plantillas del sistema): permite mezclar HTML dentro del Markdown. ### md.html_safe(texto) Úsela con texto **que escribe el usuario**. Las etiquetas (`\n" do print(md.html_safe(comentario)) // Texto propio (plantilla del sistema): se permite HTML crudo aviso = "# Aviso\n\n| Clave | Precio |\n|---|---:|\n| M-1 | 120.50 |\n\nPrecios con IVA\n" do print(md.html(aviso)) } ``` Salida: ```
Entregado el lunes.
| Clave | Precio |
|---|---|
| M-1 | 120.50 |
Precios con IVA
``` En una página web, inserte el resultado como texto sin escapar, por ejemplo en la salida de texto de `@http_context` o dentro de su plantilla. ## Advertencias - **`md.html_safe` no filtra enlaces `javascript:` ni `data:`**: solo desactiva el HTML crudo; `[clic](javascript:alert(1))` produce ``, y lo mismo con imágenes. Si muestra Markdown de un usuario a otros usuarios, quite antes esos enlaces, por ejemplo con `regex.replace(texto, "(?i)\\]\\(\\s*(javascript|data|vbscript):", "](#")` de [text.dkh](/es/devkron/2.0/bibliotecas/estandar/text.md), que convierte `[clic](javascript:alert(1))` en `[clic](#alert(1))`, un enlace inofensivo. Otra opción es permitir solo `https://`, `http://` y `mailto:`. - **No use `md.html` con texto de usuarios**: permitiría inyectar scripts en su sitio. - `markdown.dkh` crea los dos canales de Markdig al incluirse; inclúyalo una sola vez por programa. ## Compatibilidad `markdown.dkh` sustituye a `markdig.dkl` de `dkl-web` (Markdig 0.38.0; en 2.0 `dkl-web` ya no trae Markdig) y conserva `md2html`: con el mismo documento de prueba la salida es idéntica. Si la carpeta de `dkl` ya tiene el `Markdig.dll` 0.38.0, el zip lo reemplaza por la 1.5.0 y `markdig.dkl` sigue funcionando; no incluya `markdig.dkl` y `markdown.dkh` en el mismo programa (los dos definen `md2html`). La biblioteca `dklMarkDown` de 1.x se retira; use `md.html`.