CKEditor5 Markdown es un nuevo módulo contribuido de Drupal que añade un plugin de barra de herramientas a CKEditor5 para convertir Markdown a HTML bajo demanda.
Qué hace el módulo CKEditor5 Markdown
El módulo añade un nuevo botón en la barra de herramientas del editor CKEditor5 de Drupal. Al pulsarlo, se pega o escribe Markdown en el diálogo que aparece, se confirma y el contenido se inserta como HTML formateado en la posición del cursor.
La conversión utiliza la biblioteca marked (versión 9, licencia MIT) con compatibilidad con Markdown al estilo GitHub. La biblioteca ya está compilada vía Webpack, por lo que no se requiere ningún paso adicional de compilación frontend.
El módulo requiere Drupal 10.3 o superior, o Drupal 11, con el módulo ckeditor5 de Drupal core habilitado.
CKEditor5 Markdown: ejemplo
Por qué conversión explícita en lugar de la función oficial de pegado de Markdown
CKEditor5 incluye una función integrada de pegado de markdown que detecta Markdown en el portapapeles y lo convierte automáticamente al pegar.
Esa función sigue siendo experimental. No todas las construcciones de Markdown se detectan de forma fiable. Algunos bloques de texto pasan sin conversión alguna. La heurística de detección automática también puede interactuar con otros plugins activos: Pegar desde Office, Pegar desde Google Docs y Autoformato pueden interferir, produciendo resultados inconsistentes según el conjunto de plugins activo.
Este módulo adopta un enfoque explícito. Los editores activan la conversión intencionadamente al hacer clic en el botón de la barra de herramientas, pegar Markdown en el diálogo y confirmar. No hay monitoreo del portapapeles, ni adivinación heurística, ni casos límite por plugins en conflicto.
Otros módulos de Drupal admiten Markdown en CKEditor5, pero con un enfoque diferente: restringen el editor a una salida exclusiva de Markdown o permiten formatos mixtos que pueden generar conflictos en la salida. Ese enfoque funciona para un sitio personal donde una única persona controla tanto el contenido como el formato. Sin embargo, puede no funcionar de manera robusta para un sitio web corporativo donde los equipos editoriales combinan fuentes de contenido y la consistencia de la salida es importante.
Cómo instalar y configurar el módulo
Se puede instalar, como siempre, usando Composer:
composer require drupal/ckeditor5_markdown
drush en ckeditor5_markdown
El módulo también puede habilitarse a través de la interfaz de administración de Drupal después del paso de Composer.
Para configurar el editor, ir a Administración > Configuración > Creación de contenido > Formatos de texto y editores. Editar el formato de texto que utiliza CKEditor5 y arrastrar el botón Pegar Markdown a la barra de herramientas activa.
CKEditor5 filtra el HTML que acepta según los plugins y funciones habilitados en su configuración. El módulo convierte Markdown a HTML, pero CKEditor5 eliminará silenciosamente cualquier elemento que no esté permitido por el conjunto de plugins activo. Por ejemplo, un # Encabezado 1 en el Markdown solo se inserta como un elemento si el plugin de Encabezados está habilitado y está configurado como un nivel de encabezado permitido. Revisar la configuración de la barra de herramientas y los plugins de CKEditor5 antes de usar el botón para confirmar que los elementos HTML correspondientes al Markdown deseado están permitidos.
Consideraciones finales
La conversión explícita de Markdown es más predecible que la detección automática para cualquier editor que trabaje en un entorno de formatos mixtos. El módulo cubre una necesidad específica: conversión fiable e intencionada de Markdown a HTML para Drupal y CKEditor5, sin limitar el sitio a una salida exclusiva de Markdown ni aceptar la imprevisibilidad de la detección experimental del portapapeles.
Este módulo se ha construido porque Markdown a Drupal es el flujo de trabajo que uso habitualmente: redacto en Markdown, a menudo con ayuda de IA, y luego lo pego en CKEditor5 para la edición y publicación final. Este módulo forma parte de la misma filosofía de creación, priorizando el contenido, como el módulo Content First.
Prueba el módulo: https://www.drupal.org/project/ckeditor5_markdown
