Dos representaciones de un documento
Markdown permite señalar títulos, énfasis, listas y enlaces mediante signos breves. HTML nombra esas estructuras con elementos como h2, strong, ul y a. Un procesador interpreta Markdown y genera HTML; no sustituye indiscriminadamente cada asterisco o almohadilla. El contexto determina si un signo inicia un título o forma parte del texto. HTML también admite atributos, anidamiento y reglas de análisis del navegador que la notación abreviada de Markdown no siempre puede expresar.
Usa Markdown cuando convenga editar la fuente como texto sencillo. Usa HTML si el destino requiere elementos explícitos o necesitas revisar lo que recibirá el navegador. Identifica antes la variante de Markdown que acepta el sistema. MultiVerto cubre un subconjunto documentado: títulos, párrafos, listas simples, énfasis, enlaces y código en línea en ambos sentidos. Los bloques de código delimitados solo funcionan hacia HTML. Algunas construcciones no admitidas se rechazan; otras aparecen como texto literal.
Ejemplo de ida y vuelta
Escribe dos almohadillas seguidas de Notas, deja una línea vacía y añade la frase Un borrador **listo**. La herramienta crea un elemento h2 con Notas y un párrafo donde strong rodea la palabra listo. El navegador muestra el título y la palabra destacada, mientras que la fuente HTML conserva los límites de cada elemento. El ejemplo interactivo incluye un enlace: su dirección queda en el atributo href, no como puntuación visible.
Lleva ese HTML admitido al conversor de HTML a Markdown. Puede expresar h2 mediante almohadillas, strong con asteriscos y el enlace con texto entre corchetes seguido de la URL. El documento puede verse igual después de las dos conversiones aunque cambien espacios, saltos de línea o la escritura exacta de la fuente. Compara la estructura visible y el destino del enlace; no exijas que los bytes de Markdown coincidan con los iniciales.
- Markdown: ## Notas y **listo**
- HTML: elementos h2 y strong
- Markdown otra vez: revisar título, énfasis y enlace
Dónde se pierde información
HTML ofrece estructuras y atributos sin equivalente breve en Markdown. Un span con estilos, una tabla, un atributo personalizado o listas anidadas pueden perderse al convertir; esta herramienta local rechaza muchos de esos casos. En el otro sentido, distintos procesadores Markdown aceptan tablas, casillas de tareas, citas o HTML incrustado de maneras diferentes. MultiVerto rechaza varias de esas construcciones en vez de inventar una salida silenciosa. Que funcione un ejemplo pequeño no valida un documento complejo.
Incluso una estructura admitida puede escribirse de varias formas. Tanto strong como b pueden volver como asteriscos, y se pierde la elección original de etiqueta. El navegador también puede reparar HTML mal formado. Antes de publicar, inspecciona el marcado generado y comprueba su aspecto en el sistema de destino. Conserva el archivo original para recuperar atributos, comentarios o decisiones de presentación que la representación más sencilla no puede guardar.
Escapar caracteres no es crear marcado
Codificar un carácter HTML para mostrarlo no equivale a convertir Markdown en estructura HTML. Si quieres que el lector vea literalmente <h2>Notas</h2>, representa los signos angulares mediante entidades o usa un contexto de código fiable. Si quieres un título, produce el elemento h2 real. El codificador de entidades enlazado abajo cambia la representación del texto; el conversor Markdown crea elementos. Trata como no fiable el contenido aportado por otras personas en cualquiera de los dos recorridos.
El conversor local escapa el texto plano de su subconjunto admitido. Para publicar aportaciones arbitrarias sigue siendo aconsejable un procesador mantenido y un saneador adecuado cuando puedan aparecer enlaces o etiquetas. Revisa qué URL y elementos permite el destino. Un procedimiento útil es convertir un ejemplo, inspeccionar su HTML, visualizarlo y devolver solo la parte admitida. Si desaparece una función, mantén como original autorizado el formato que puede conservarla.