En este tutorial, crearemos una función auxiliar en una aplicación Laravel para convertir contenido de Markdown a HTML usando la biblioteca league/commonmark. Cubriremos los pasos para crear un archivo auxiliar, incluirlo en nuestro proyecto Laravel y usarlo en una plantilla Blade. Este mecanismo se utiliza en Laravel 11 para que las funciones estén disponibles globalmente.

Opcional: Manejo de la conversión de Markdown en el controlador

La alternativa es manejar la conversión de Markdown en el controlador antes de pasar los datos a la vista, por lo que ya no necesitamos crear un archivo auxiliar:

use League\CommonMark\CommonMarkConverter;

public function show($id)
{
    $course = Course::find($id);
    $converter = new CommonMarkConverter();

    $post->description = $converter->convertToHtml($post->description);

    return view('post.show', compact('post'));
}

Crear un archivo auxiliar para que la función de conversión esté disponible en la plantilla Blade

Paso 1: Instalar liga/commonmark

Primero, instalamos la biblioteca league/commonmark a través de Composer:

composer require league/commonmark

Paso 2: crea el archivo helpers.php

A continuación, crearemos un archivo helpers.php para definir nuestra función auxiliar. Este archivo se puede colocar en el directorio de la aplicación o en cualquier otra ubicación preferida.

touch app/helpers.php

Abre app/helpers.php y agrega el siguiente contenido:

convertToHtml($markdown);
    }
}

Paso 3: incluir el archivo auxiliar en Composer

Para garantizar que Laravel cargue automáticamente el archivo helpers.php, debemos modificar el archivo compositor.json para agregar la ruta a helpers.php en la sección de carga automática:

"autoload": {
    "files": [
        "app/helpers.php"
    ]
}

Paso 4: regenerar los archivos de carga automática de Composer

Después de modificar Composer.json, regenere los archivos de carga automática de Composer ejecutando:

composer dump-autoload

Paso 5: utilice la función auxiliar en las plantillas Blade

Con la función auxiliar definida y cargada, ahora podemos usarla en las plantillas Blade para convertir Markdown a HTML:

    {!! markdownToHtml($post->description) !!}

Este tutorial se proporciona para mostrar cómo podemos hacer que las funciones personalizadas estén disponibles en las plantillas Blade.