Convertir HTML a Markdown

Cómo funciona

Usted va a mover una entrada de blog antigua, una página de wiki o un boletín por correo a algo que funciona con Markdown: GitHub, Notion, Obsidian o un generador de sitios estáticos. Pegue el HTML en el panel izquierdo y el Markdown aparece a la derecha. Por ejemplo, <h2>Pasos</h2> pasa a ## Pasos, <strong>5 minutos</strong> pasa a **5 minutos**, una lista anidada conserva su sangría y una tabla sale como tabla GFM con barras verticales. Si la clase de un bloque de código indica un lenguaje (language-bash), se escribe en la línea de apertura. Los bloques script y style se quitan; todo lo que tiene que ver con la apariencia no existe en Markdown y se pierde, el texto queda. La línea de resultado cuenta títulos, listas, tablas, enlaces y bloques quitados.

Esta herramienta también se busca como convertir html a markdown, html a markdown, html to markdown, pagina web a markdown, html a md.

¿Qué es Markdown?

Markdown es una forma de escribir texto plano en la que los signos de puntuación marcan el formato: una almohadilla al inicio de la línea crea un título, dos asteriscos ponen negrita, un guion abre un elemento de lista. El archivo se lee bien aunque no se procese; por eso lo usan los README, las aplicaciones de notas y los sitios de documentación.

¿Qué es Tabla GFM?

Una tabla GFM (GitHub Flavored Markdown) separa las columnas con barras verticales y pone bajo la fila de encabezado una fila de guiones. El Markdown original no tiene tablas; esta extensión se difundió con GitHub y hoy la entienden casi todos los programas de Markdown. No admite celdas combinadas ni celdas con varias líneas.

¿Cuál es la diferencia entre HTML y Markdown?

HTML le dice al navegador cada detalle de una página: estructura, apariencia y comportamiento. Markdown lleva solo la estructura y está pensado para que lo lean personas. Al pasar de HTML a Markdown se conservan títulos, listas, tablas, enlaces y énfasis, y se pierden colores, tipos de letra y diseño. Es a propósito: un texto en Markdown se lee igual en todas partes y es fácil de editar.

Lo que Markdown no puede llevar

Markdown describe solo una parte pequeña del HTML. El color, el tamaño de letra, la alineación y las columnas no tienen lugar en él; se quitan y el texto que contienen se conserva.

Una tabla con celdas combinadas (colspan, rowspan) no se puede escribir como tabla GFM. La herramienta la simplifica y agrega «tabla con celdas combinadas simplificada» a la línea de resultado; revise esa tabla en la salida.

Los caracteres que significan algo en Markdown (asterisco, guion bajo, corchetes) reciben una barra invertida en el texto normal, para que una palabra como nombre_archivo no pase a cursiva.

Qué opción elegir

Los títulos con almohadilla funcionan casi en todas partes y son la única forma de escribir los niveles tres a seis. Los títulos subrayados existen solo para los niveles uno y dos; algunos README antiguos y herramientas de documentación los prefieren. Con esta opción, del nivel tres en adelante se sigue usando la almohadilla.

La lista de referencias mantiene legibles los textos largos con muchos enlaces: en el texto solo aparece [página][1] y las direcciones se juntan al final. En textos cortos, los enlaces dentro del texto son más prácticos.

Preguntas frecuentes

¿Puedo pegar una página web completa?

Sí. Se quitan la sección head, los scripts y los estilos, y se convierte el contenido del body. El menú, el pie de página y la barra lateral también llegan a la salida como texto; si solo quiere el artículo, copie solo esa parte del código fuente.

¿Qué pasa con las imágenes?

Cada imagen se convierte en una línea ; la imagen no se descarga, solo se escribe su dirección. Las imágenes incrustadas en la página (dirección que empieza con data:) se omiten porque son larguísimas.

¿Puedo convertir el Markdown de vuelta a HTML?

Sí, con la herramienta para convertir Markdown a HTML. Las dos se complementan: el Markdown que obtiene aquí se puede volver a pasar a HTML allí.

¿Mi HTML se sube a algún servidor?

No. La biblioteca que hace la conversión funciona en su navegador; el código que pega no va a ningún servidor.