Convertidor de Markdown

Convierte entre Markdown y HTML con vista previa

Instrucciones de uso

🚀 Inicio rápido

  • Pega el contenido en el campo izquierdo
  • Elige el modo (→HTML o →Markdown)
  • Conversión automática; resultado a la derecha
  • Vista previa/Salida HTML: Markdown → HTML renderiza KaTeX/Mermaid por defecto

📌 Escenarios comunes

  • Blogs/Docs: comprobar rápidamente el renderizado y los colores
  • Envío por correo: pegar el HTML exportado en el cuerpo del correo (mejor con estilos en línea)
  • Rich text → Markdown: limpiar rich text de web/CMS para gestionarlo en versiones
  • Documentación técnica: renderizar fórmulas/diagramas y exportar de una vez
  • Migración de editores: conciliar diferencias entre sabores de Markdown
  • Wiki/KB: convertir páginas HTML a Markdown para importarlas
  • Changelog de API: pasar HTML/descripciones a Markdown para revisión/PR

🎛️ Parámetros de conversión y renderizado

  • Markdown → HTML renderiza KaTeX/Mermaid automáticamente
  • HTML → Markdown conserva/restaura la fuente; no re‑renderiza
  • GFM (tablas/tareas) activado por defecto; usa Markdown estándar para un comportamiento estricto
  • Saltos suaves activados; para un comportamiento estricto usa líneas en blanco o dos espacios al final
  • Las entradas muy grandes pueden activar una vista previa degradada (limitar renderizado/desactivar resaltado)

🧭 Consejos de uso

  • Correo: usa estilos en línea para mejor compatibilidad
  • Textos largos: conviértelos por partes para evitar lentitud

⚠️ Limitaciones y compatibilidad

  • Variantes: el renderizado varía según la plataforma; usa sintaxis común
  • HTML → Markdown es de mejor esfuerzo: estilos/maquetación suelen perderse
  • HTML → Markdown ignora partes del HTML (scripts/estilos/meta, incrustados/formularios, medios, eventos on*, style/class, etc.)
  • Tablas complejas/anidado pueden degradarse; revisa
  • Imágenes/vídeo siguen como enlaces externos; no se descargan
  • Los SVG Mermaid prerenderizados por terceros no se invierten de forma fiable

🔒 Privacidad y seguridad

  • Todo el procesamiento se realiza en tu navegador; los datos no salen de tu dispositivo
  • No ejecuta <script> pegados
  • KaTeX/Mermaid con configuración segura
  • No limpia todo el HTML automáticamente; revisa antes/después de convertir

❓ Preguntas frecuentes

La vista previa difiere de la plataforma destino: ¿cómo diagnosticar?

Identifica el sabor de Markdown destino (CommonMark/GFM/personalizado). Evita HTML crudo y extensiones privadas. Usa saltos estándar (líneas en blanco o dos espacios al final). Reduce a un ejemplo mínimo, verifica en el destino y luego expande.

¿Cómo publicar HTML exportado de forma segura en producción?

La herramienta no ejecuta <script>, pero tampoco sanea automáticamente. Sanea en el servidor/pipeline con una librería de lista blanca (p. ej., DOMPurify), bloquea on* y esquemas peligrosos, y aplica CSP para scripts externos/en línea.

HTML → Markdown distorsiona estructuras complejas: ¿qué hacer?

Prefiere semánticas portables: convierte tablas/listas anidadas en tablas de tubería y listas más planas; pega como texto plano para eliminar span/style/class antes de convertir; aísla un caso mínimo y ajusta la fuente.

Límites y resolución de problemas de KaTeX/Mermaid

Sintaxis: KaTeX $$…$$ o en línea $…$; Mermaid cercado como ```mermaid. Entradas grandes pueden degradarse (mostrar fuente/desactivar resaltado). Reduce densidad, convierte por partes y usa ejemplos mínimos para localizar errores. Recuperación: KaTeX puede recuperarse del HTML renderizado; Mermaid solo para diagramas generados por esta herramienta con fuente incrustada.

Convertidor Markdown - Convertir, Vista Previa, Resaltado Código - CrateX.app