عرض مصدر Twig/html to markdown

<noinclude>{{DISPLAYTITLE: المرشح html_to_markdown في Twig}}</noinclude>
يحول المرشح <code>html_to_markdown</code> كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون:<syntaxhighlight lang="twig">
{% apply html_to_markdown %}
    <html>
        <h1>Hello!</h1>
    </html>
{% endapply %}
</syntaxhighlight>
من الممكن استخدام المرشح على كامل القالب الذي تدرجه باستخدام <code>include</code>:<syntaxhighlight lang="twig">
{{ include('some_template.html.twig')|html_to_markdown }}
</syntaxhighlight>

لاحظ أن المرشح <code>html_to_markdown</code>  جزء من <code>MarkdownExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig">
$ composer require twig/markdown-extra
</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig">
$ composer require twig/extra-bundle
</syntaxhighlight>أو أضف التوسيع صراحة إلى بيئة Twig:<syntaxhighlight lang="twig">
use Twig\Extra\Markdown\MarkdownExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new MarkdownExtension());
</syntaxhighlight>إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسيع (extension runtime): <syntaxhighlight lang="twig">
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());
        }
    }
});
</syntaxhighlight>

المرشح <code>html_to_markdown</code> مجرد واجهة أمامية للتحويل الحقيقي الذي يتم بإحدى المكتبات التالية:

* [https://github.com/erusev/parsedown erusev/parsedown]
* [https://github.com/thephpleague/html-to-markdown thephpleague/html-to-markdown]
* [https://github.com/michelf/php-markdown michelf/php-markdown]

تضاف بعض الخيارات وفقًا للمكتبة المستخدمة، وذلك بتمريرها كوسائط إلى المرشح. انظر المثال التالي لمكتبة <code>league/html-to-markdown</code>:<syntaxhighlight lang="twig">
{% apply html_to_markdown({hard_break: false}) %}
    <html>
        <h1>Hello!</h1>
    </html>
{% endapply %}
</syntaxhighlight>