Markdown a HTML: un flujo de publicación limpio

Un flujo de publicación necesita un formato máster que sobreviva a herramientas, alojamientos y rediseños. Ese máster es el Markdown de texto plano: legible en cualquier editor, comparable en el control de versiones e independiente de la plantilla HTML que lo renderice este año.

La disciplina que lo hace funcionar es el flujo unidireccional: el Markdown se edita a mano, el HTML lo produce el conversor y nadie parchea la salida manualmente. En el momento en que el HTML exportado recibe ediciones a mano, hay dos másteres y acabarán divergiendo.

• PortablePortabilidad: un archivo Markdown se abre en cualquier editor y se convierte a HTML, PDF, diapositivas o un sistema de documentación sin proyecto de migración.
• ComparableRevisabilidad: los cambios de prosa aparecen como diffs de línea limpios, mientras que un máster en HTML entierra la edición de una palabra entre etiquetas y atributos.
• Estructura, no estiloSeparación de responsabilidades: la fuente porta la estructura—títulos, listas, citas—mientras el tema decide la tipografía, así que un rediseño nunca toca el archivo.

Los conversores deliberados admiten un subconjunto a propósito, porque cada constructo admitido es una vía más para colar marcado que nadie revisó. Conoce dónde se sitúa tu contenido respecto a esa línea antes de confiar en la conversión.

En el modo Markdown a HTML, la sintaxis de imagen conserva solo el texto alternativo, no la imagen ni su URL; el HTML sin procesar se escapa como texto. En el modo HTML a Markdown, una tabla pegada se convierte en un bloque de texto cercado y pierde su cuadrícula. Revisa el resultado antes de publicarlo.

• Conversiones limpiasConversión limpia: títulos de hasta seis niveles, párrafos, negrita, cursiva, tachado, código en línea, bloques de código con cercas, listas ordenadas y desordenadas, citas en bloque, reglas horizontales y enlaces en línea.
• Pérdidas conocidasFuera del subconjunto admitido, el resultado depende de la dirección: la sintaxis de imagen en Markdown conserva solo el texto alternativo, el HTML sin procesar en Markdown se escapa como texto y las tablas HTML se convierten en bloques de texto cercados al volver a Markdown. Comprueba las notas al pie y las listas de tareas en el resultado en vez de dar por hecho que sobreviven.
• Prueba con un artículo realLa prueba es simple: convierte un artículo representativo y lee la salida. Lo que falte en el resultado nunca estuvo en el contrato.

El HTML convertido puede insertarse en una página, por lo que la herramienta lo sanea por defecto. Elimina los elementos activos, desenvuelve las etiquetas desconocidas y quita los atributos salvo las URL de enlaces permitidas y los inicios válidos de listas numeradas.

El panel de vista previa renderiza la salida desinfectada y nunca carga recursos remotos, así que ni siquiera pegar marcado hostil puede hacer que la propia herramienta llame a casa.

• Contenido activo eliminadoLos elementos con comportamiento activo—script, style, iframe, object, embed, svg, form, video, audio, img—se eliminan con su contenido, no solo se neutralizan.
• Atributos retiradosSe eliminan los estilos en línea, los manejadores de eventos y las clases del origen. Los enlaces seguros conservan href y las listas numeradas válidas conservan start.
• Reportado, no silenciosoEl área informa de lo que eliminó—recuentos de nodos desechados y atributos retirados—así que la desinfección es un evento visible, no una mutación silenciosa.

Un documento renderizado es en su mayoría enlaces, y los enlaces son donde la desinfección se vuelve específica. El conversor acepta URL http, https y mailto más #fragmentos dentro de la página; cualquier otra cosa—javascript:, data:, trucos de protocolo relativo—pierde su href y se renderiza como texto plano.

Comprueba la lista de permitidos contra tu contenido antes de estandarizar un conversor: un conjunto de documentación que enlaza legítimamente a espejos FTP o esquemas de aplicación propios necesita conservar esos enlaces a mano, porque ningún desinfectante sensato los dejará pasar automáticamente.

• Lista de esquemas permitidosLos enlaces supervivientes se sellan con rel="noreferrer noopener", de modo que un enlace seguido no puede ver ni scriptar la página desde la que se abrió.
• noopener noreferrerLa misma regla aplica en ambas direcciones: los enlaces escritos en Markdown se comprueban al convertir, y los href encontrados en HTML pegado se vuelven a comprobar tras la desinfección.
• Las etiquetas sobrevivenCuando un enlace pierde su esquema, el texto de la etiqueta permanece: la navegación rota se ve de inmediato en lugar de enviar una carga javascript: silenciosa.

Convertir HTML a Markdown sirve para recuperar contenido, no para completar una ida y vuelta sin pérdidas. Los títulos, párrafos, énfasis, listas, citas y código admitidos vuelven como Markdown. Otras estructuras pueden simplificarse o eliminarse durante el saneamiento y la conversión.

Trata el HTML-a-Markdown como una forma de sacar prosa de una página que ya no controlas: una exportación de un CMS viejo, un documento que solo existe como HTML renderizado. Luego repara lo que el viaje de vuelta no puede: vuelve a añadir las imágenes, reconstruye las tablas y, desde entonces, conserva el Markdown como máster.

• Las tablas colapsanLas tablas pierden su cuadrícula y se convierten en un bloque de texto cercado, así que los datos tabulares requieren rehacerse o exportarse a CSV.
• El medio se eliminaImágenes, vídeo e incrustaciones interactivas desaparecen por diseño: el desinfectante los eliminó como contenido activo antes de construir el Markdown.
• El texto sobrevive al estiloEl formato fuera del subconjunto—spans, divs, clases, destinos de ancla—no deja rastro; el texto sobrevive, la presentación no.

El paso de conversión corre al publicar, una vez por artículo: redacta y revisa en Markdown, convierte a HTML desinfectado, verifica el resultado renderizado y envía. Todo ocurre en la pestaña del navegador—el borrador nunca se sube, lo que importa cuando el contenido es un lanzamiento no anunciado.

• Paso al publicarEl área acepta hasta 256 KiB de fuente y produce hasta 512 KiB de salida—holgado para un capítulo de libro—y reporta un error explícito al pasar de esos límites en lugar de truncar en silencio.
• Límites explícitosCopia la salida en el campo de tu CMS o descárgala como archivo; ambas vías toman el mismo documento desinfectado que mostró la vista previa.
• Reconvierte, no parcheesGuarda el Markdown en el control de versiones junto al código que documenta, y reconvierte tras cada edición en lugar de parchar HTML viejo.