66 lines
1.7 KiB
ReStructuredText
66 lines
1.7 KiB
ReStructuredText
``markdown_to_html``
|
|
====================
|
|
|
|
.. versionadded:: 2.12
|
|
The ``markdown_to_html`` filter was added in Twig 2.12.
|
|
|
|
The ``markdown_to_html`` filter converts a block of Markdown to HTML:
|
|
|
|
.. code-block:: twig
|
|
|
|
{% apply markdown_to_html %}
|
|
Title
|
|
======
|
|
|
|
Hello!
|
|
{% endapply %}
|
|
|
|
Note that you can indent the Markdown content as leading whitespaces will be
|
|
removed consistently before conversion:
|
|
|
|
.. code-block:: twig
|
|
|
|
{% apply markdown_to_html %}
|
|
Title
|
|
======
|
|
|
|
Hello!
|
|
{% endapply %}
|
|
|
|
You can also use the filter on an included file:
|
|
|
|
.. code-block:: twig
|
|
|
|
{{ include('some_template.markdown.twig')|markdown_to_html }}
|
|
|
|
.. note::
|
|
|
|
The ``markdown_to_html`` filter is part of the ``MarkdownExtension`` which
|
|
is not installed by default. Install it first:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ composer req twig/markdown-extra
|
|
|
|
Then, use the ``twig/extra-bundle`` on Symfony projects or add the extension
|
|
explictly on the Twig environment::
|
|
|
|
use Twig\Extra\Markdown\MarkdownMarkdownExtension;
|
|
|
|
$twig = new \Twig\Environment(...);
|
|
$twig->addExtension(new MarkdownExtension());
|
|
|
|
If you are not using Symfony, you must also register the extension runtime::
|
|
|
|
use Twig\Extra\Markdown\DefaultMarkdown;
|
|
use Twig\Extra\Markdown\MarkdownRuntime;
|
|
use Twig\RuntimeLoader\RuntimeLoaderInterface;
|
|
|
|
$twig->addRuntimeLoader(new class implements RuntimeLoaderInterface {
|
|
public function load($class) {
|
|
if (MarkdownRuntime::class === $class) {
|
|
return new MarkdownRuntime(new DefaultMarkdown());
|
|
}
|
|
}
|
|
});
|