Add custom file extensions to blade

BladeServiceProvider.php

<?php // app/Providers/BladeServiceProvider.php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class BladeServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        // Register *.blade.yaml files as blade views.
        resolve(\Illuminate\View\Factory::class)->addExtension('blade.yaml', 'blade');
    }
}

DocsController.php

<?php // app/Http/Controllers/DocsController.php

namespace App\Http\Controllers;

use Illuminate\Http\Response;

class DocsController extends Controller
{
    /**
     * @param string $path
     *
     * @return \Illuminate\Http\Response
     * @throws \Throwable
     */
    public function show(string $path)
    {
        // Parse the URL path so Laravel can find the corresponding view.
        $path = str_replace('.yaml', '', $path);
        $view = str_replace('/', '.', $path);
        $view = 'docs.' . $view;
        $pathParts = explode('/', $path);
        $filename = array_last($pathParts);

        // 404 if the view does not exist.
        if (!view()->exists($view)) {
            abort(Response::HTTP_NOT_FOUND);
        }

        // Parse the YAML Blade template and retrieve the string contents.
        $yaml = view($view)->render();

        return response()->make($yaml, Response::HTTP_OK, [
            'Content-Type' => 'application/x-yaml',
            'Content-Disposition' => sprintf('inline; filename="%s.yaml"', $filename),
        ]);
    }
}

example.blade.yaml

# resources/views/example.blade.yaml

name: Example
version: 1.0
supported:
  - OAuth 2.0
  - API Token

web.php

<?php // routes/web.php

use Illuminate\Facades\Route;

Route::get('/docs/{path}', 'DocsController@show')
    ->where('path', '.*(.yaml)')
    ->name('docs.show');