markdown_to_html

The markdown_to_html filter converts a block of Markdown to HTML:

markdown_to_html フィルターは、Markdown のブロックを HTML に変換します。
1
2
3
4
5
6
 
{% apply markdown_to_html %}
Title
======

Hello!
{% endapply %}

Note that you can indent the Markdown content as leading whitespaces will be removed consistently before conversion:

先頭の空白は変換前に一貫して削除されるため、Markdown コンテンツをインデントできることに注意してください。
1
2
3
4
5
6
 
{% apply markdown_to_html %}
    Title
    ======

    Hello!
{% endapply %}

You can also use the filter on an included file or a variable:

インクルードされたファイルまたは変数に対してフィルターを使用することもできます。
1
2
3
 
{{ include('some_template.markdown.twig')|markdown_to_html }}

{{ changelog|markdown_to_html }}

Note

ノート

The markdown_to_html filter is part of the MarkdownExtension which is not installed by default. Install it first:

markdown_to_html フィルタは、デフォルトではインストールされない MarkdownExtension の一部です。最初にインストールします。
1
 
$ composer require twig/markdown-extra

Then, on Symfony projects, install the twig/extra-bundle:

次に、Symfony プロジェクトで、twig/extra-bundle をインストールします。
1
 
$ composer require twig/extra-bundle

Otherwise, add the extension explicitly on the Twig environment:

それ以外の場合は、Twig 環境で拡張機能を明示的に追加します。
1
2
3
4
 
use Twig\Extra\Markdown\MarkdownExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new MarkdownExtension());

If you are not using Symfony, you must also register the extension runtime:

Symfony を使用していない場合は、拡張ランタイムも登録する必要があります。
1
2
3
4
5
6
7
8
9
10
11
 
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());
        }
    }
});

Afterwards you need to install a markdown library of your choice. Some of them are mentioned in the require-dev section of the twig/markdown-extra package.

その後、選択したマークダウン ライブラリをインストールする必要があります。それらのいくつかは、twig/markdown-extra パッケージの require-dev セクションで言及されています。

Note

ノート

If using Symfony (full-stack), twig/extra-bundle with league/commonmark as your Markdown library you can configure CommonMark extensions. Register the desired extension(s) as a service, then tag the service with twig.markdown.league_extension.

Symfony (フルスタック) を使用している場合、Markdown ライブラリとしてリーグ/コモンマークを含む小枝/追加バンドルを使用すると、CommonMark 拡張機能を構成できます。目的の拡張機能をサービスとして登録し、twig.markdown.league_extension でサービスにタグを付けます。