PHPackages                             ryangjchandler/commonmark-blade-block - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ryangjchandler/commonmark-blade-block

ActiveLibrary

ryangjchandler/commonmark-blade-block
=====================================

Embed Laravel Blade code inside of your Markdown templates.

v1.1.1(1mo ago)212.5k[1 PRs](https://github.com/ryangjchandler/commonmark-blade-block/pulls)2MITPHPPHP ^8.2CI passing

Since Oct 17Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/ryangjchandler/commonmark-blade-block)[ Packagist](https://packagist.org/packages/ryangjchandler/commonmark-blade-block)[ Docs](https://github.com/ryangjchandler/commonmark-blade-block)[ GitHub Sponsors]()[ RSS](/packages/ryangjchandler-commonmark-blade-block/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (28)Versions (8)Used By (2)

Embed Laravel Blade code inside of your Markdown templates.
===========================================================

[](#embed-laravel-blade-code-inside-of-your-markdown-templates)

[![Latest Version on Packagist](https://camo.githubusercontent.com/67e219aeb6689d05e13c4a47c247514e2c3eac0107e2541dea14149657a61b72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7279616e676a6368616e646c65722f636f6d6d6f6e6d61726b2d626c6164652d626c6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ryangjchandler/commonmark-blade-block)[![GitHub Tests Action Status](https://camo.githubusercontent.com/b5efb4d09458d9e3e203dc63fc316d7ecfc1ea0d17666dcf7af0775f79ffd190/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7279616e676a6368616e646c65722f636f6d6d6f6e6d61726b2d626c6164652d626c6f636b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/ryangjchandler/commonmark-blade-block/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/525d1ecd123976fcc891cb1ea71cf2192f9ffccc8147e826c5637b6747e224e5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7279616e676a6368616e646c65722f636f6d6d6f6e6d61726b2d626c6164652d626c6f636b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/ryangjchandler/commonmark-blade-block/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/4a2e9ecf3d5c9e3e56f73ad67e2be15d0dbc75c86136237b1444b7a8504a3b8b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7279616e676a6368616e646c65722f636f6d6d6f6e6d61726b2d626c6164652d626c6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ryangjchandler/commonmark-blade-block)

This package provides an extension for [`league/commonmark`](https://github.com/thephpleague/commonmark) that lets you embed [Laravel Blade code](https://laravel.com/docs/blade) inside of your Markdown content.

Installation
------------

[](#installation)

You can install the package via Composer:

```
composer require ryangjchandler/commonmark-blade-block
```

Usage
-----

[](#usage)

Start by registering the extension.

```
use League\CommonMark\MarkdownConverter;
use League\CommonMark\Environment\Environment;
use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
use RyanChandler\CommonmarkBladeBlock\BladeExtension;

$environment = new Environment();

$environment
    ->addExtension(new CommonMarkCoreExtension)
    ->addExtension(new BladeExtension);

$converter = new MarkdownConverter($environment);
```

Then start embedding Blade inside of your Markdown content with the `@blade` and `@endblade` tags.

```
# Hello, world!

@blade

    Click me!

@endblade
```

### Using Laravel's `Str` or `str()` helpers

[](#using-laravels-str-or-str-helpers)

If you're using `Str::markdown()` or `str()->markdown()`, then you can register the extension through the `extensions` argument.

```
Str::markdown(