PHPackages                             jralph/twig-markdown - 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. [Templating & Views](/categories/templating)
4. /
5. jralph/twig-markdown

ActiveLibrary[Templating & Views](/categories/templating)

jralph/twig-markdown
====================

A simple twig markdown extension.

2.4.1(7y ago)1174.2k↓50%4[4 issues](https://github.com/jralph/Twig-Markdown/issues)3MITPHPPHP ~7.0

Since Feb 18Pushed 2y ago1 watchersCompare

[ Source](https://github.com/jralph/Twig-Markdown)[ Packagist](https://packagist.org/packages/jralph/twig-markdown)[ RSS](/packages/jralph-twig-markdown/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (4)Versions (11)Used By (3)

Twig Markdown Extension
=======================

[](#twig-markdown-extension)

**Updated for Twig 2.\* - For Twig 1.\* please use version 1.0.1**

A simple and extendable twig extension for providing markdown filters, globals, tags and functions.

By default, this extension comes with [ParsedownExtra](https://github.com/erusev/parsedown-extra), but this can be easily replaced with any markdown processor or your choice by simply implementing the provided interface and passing your new implementation into the extension.

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

[](#installation)

You can simply install the extension package through composer.

```
composer require jralph/twig-markdown

```

You can also add the package and the version you want to your composer.json file.

```
"require": {
    "jralph/twig-markdown": "dev-master"
}

```

Setup With Twig
---------------

[](#setup-with-twig)

To use this extension with twig (without any additions such as TwigBridge for Laravel. *See below.*), you can simply do the following.

```
$twig = new Twig_Environment($loader);
$twig->addExtension(new Jralph\Twig\Markdown\Extension(
    new Jralph\Twig\Markdown\Parsedown\ParsedownExtraMarkdown
));
```

Setup With TwigBridge for Laravel 5
-----------------------------------

[](#setup-with-twigbridge-for-laravel-5)

To use this plugin with [TwigBridge](https://github.com/rcrowe/TwigBridge) for Laravel, it is just as easy, but you have multiple ways of adding the extension.

**Via config/twigbridge.php**

You can add the extension directly to the `enabled` section of the `extensions` array within the `config/twigbridge.php` file. (Note, you will need to make sure that the config file has been published `php artisan vendor:publish` for this file to exist.)

```
'extensions' => [

    'enabled' => [
        // Other TwigBridge Extensions
        new Jralph\Twig\Markdown\Extension(
            new Jralph\Twig\Markdown\Parsedown\ParsedownExtraMarkdown
        ),
    ]

]
```

**Via Twig Facade**

You can also add the extension using the `Twig` facade that TwigBridge provides.

```
Twig::addExtension(new Jralph\Twig\Markdown\Extension(
    new Jralph\Twig\Markdown\Parsedown\ParsedownExtraMarkdown
));
```

You can add this code to your Laravel 5 install in any way you like, but we recommend using a service provider.

Security
--------

[](#security)

Due to any and all HTML being perfectly valid within Markdown, this package does not choose to pre-sanitise input, and only pre-sanitises input when forced (the `tag` functionality does this).

Care should be taken when using the `filter`, `function`, or `global` combined with user input, as this could potentially lead to XSS vulnerabilities. Generally speaking you would want to strip `` tags from any output as a bare minimum.

Provided Functionality
----------------------

[](#provided-functionality)

The Twig-Markdown extension provides globals, functions, filters and tags to assist you with your markdown processing.

### Tag (Input Safe)

[](#tag-input-safe)

We also provide a handy tag for you to use if you want to write the markdown within a template.

```
{% markdown %}
    # Some Markdown

    This is some simple markdown content.

    {{ moreMarkdown }}
{% endmarkdown %}

```

**NOTE: Filter input is sanitised automatically. The tag will not work with markdown that contains HTML.**

### Filter (Input Unsafe, No HTML Support)

[](#filter-input-unsafe-no-html-support)

Use just like any other twig filter.

```
{{ "# Some Markdown" | markdown }}
{{ markdownVariable | markdown }}

{% apply markdown %}
    # Some Markdown

    This is some simple markdown content.

    {{ moreMarkdown }}
{% endapply %}

```

**NOTE: The above filter usage is unsafe. Filter input is not automatically sanitised. To sanitise this in the template, please use the escape filter like below.**

```
{{ markdownVariable | escape | markdown }}

```

### Function (Input Unsafe, HTML Support)

[](#function-input-unsafe-html-support)

Use just like any other twig function.

```
{{ markdown("# Some Markdown") }}
{{ markdown(markdownVariable) }}

```

**NOTE: The above function usage is unsafe. Function input is not automatically sanitised. To sanitise this in the template, please use the escape filter like below.**

```
{{ markdown(markdownVariable | escape) }}

```

### Global (Input Unsafe, HTML Support)

[](#global-input-unsafe-html-support)

You can also use the global for direct access to the implementation of the MarkdownInterface contract.

```
{% autoescape false %}
    {{ markdown.parse("# Some Markdown") }}
    {{ markdown.parse(markdownVariable) }}
{% endautoescape %}

```

*Note the use of the `{% autoescape false %}`. Without this, the generated html will be escaped......which may or may not be what you are looking for. If you wish to escape the input, but keep html output, you can do so like below*

```
{% autoescape false %}
    {{ markdown.parse(markdownVariable | escape) }}
{% endautoescape %}

```

Using Another Processor
-----------------------

[](#using-another-processor)

Want to use another processor other than ParsedownExtra? No problem!

Just implement the `Jralph\Twig\Markdown\Contracts\MarkdownInterface` contract, add it to the extension and you're away.

The contract requires the following methods:

- `parse($text)`;
    - This method should return the parsed `$text`.

Example using [Michelf Markdown](https://github.com/michelf/php-markdown).

```
// MichelfMardown.php