Neste tutorial, criaremos uma função auxiliar em um aplicativo Laravel para converter conteúdo Markdown em HTML usando a biblioteca league/commonmark. Abordaremos as etapas para criar um arquivo auxiliar, incluí-lo em nosso projeto Laravel e usá-lo em um modelo Blade. Este mecanismo é usado no Laravel 11 para disponibilizar funções globalmente.

Opcional: Tratamento da conversão de Markdown no controlador

A alternativa é lidar com a conversão do Markdown no controlador antes de passar os dados para a visualização, para que não precisemos mais criar um arquivo 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'));
}

Criando um arquivo auxiliar para disponibilizar a função de conversão no modelo Blade

Passo 1: Instalar liga/marca comum

Primeiro, instalamos a biblioteca league/commonmark via Composer:

composer require league/commonmark

Etapa 2: crie o arquivo helpers.php

A seguir, criaremos um arquivo helpers.php para definir nossa função auxiliar. Este arquivo pode ser colocado no diretório do aplicativo ou em qualquer outro local de sua preferência.

touch app/helpers.php

Abra app/helpers.php e adicione o seguinte conteúdo:

convertToHtml($markdown);
    }
}

Etapa 3: incluindo o arquivo auxiliar no Composer

Para garantir que o Laravel carregue automaticamente o arquivo helpers.php, precisamos modificar o arquivo compositor.json para adicionar o caminho para helpers.php na seção de carregamento automático:

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

Etapa 4: regenerar arquivos de carregamento automático do Composer

Depois de modificar o compositor.json, gere novamente os arquivos de carregamento automático do Composer executando:

composer dump-autoload

Etapa 5: use a função auxiliar em modelos Blade

Com a função auxiliar definida e carregada, agora podemos usá-la nos modelos Blade para converter Markdown em HTML:

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

Este tutorial é fornecido para mostrar como podemos disponibilizar funções personalizadas em modelos blade.