Markdown

Provides Markdown integration for Drupal, letting authors write in a clean, plain-text syntax that is transformed into valid HTML through a configurable filter.

The Markdown syntax is designed to co-exist with HTML, so you can build input formats that allow both. It is also meant to be as human-readable as possible when left as “source”.

Features

Markdown filter for Drupal text formats.
Site-wide default parser with per-format overrides.
Pluggable parser system to support multiple Markdown engines.
Support for both CommonMark and GitHub Flavoured Markdown via CommonMark.
Optional parser extensions and settings exposed through the UI.

Requirements

A Markdown parser:

This module bridges popular PHP Markdown libraries with Drupal by offering integration wrappers around them. The following parsers are supported out-of-the-box:

CommonMark and CommonMark GFM (highly recommended, league/commonmark):

composer require league/commonmark ^2.0

Parsedown (erusev/parsedown):

composer require erusev/parsedown

Parsedown Extra (erusev/parsedown-extra):

composer require erusev/parsedown-extra

PHP Markdown and PHP Markdown Extra (michelf/php-markdown):

composer require michelf/php-markdown

PHP/PECL Commonmark Extension (ext-cmark)
```
pecl install cmark
```

Installation

Follow the standard Drupal installation instructions:

https://www.drupal.org/docs/extending-drupal/installing-modules
Choose a Markdown parser from above and install it via Composer:

https://getcomposer.org/doc/
Enable and edit your global (default/site-wide) Markdown parser in your site:

/admin/config/content/markdown
Optionally, create a new text format or edit an existing one to add the Markdown filter to it where you can choose to inherit the site-wide settings or override the settings for that particular text format:

/admin/config/content/formats

Note: Markdown may conflict with other text format filters, depending on the order in which filters are configured to apply. If unexpected markup occurs when the text format is configured with other filters, experiment with the order of the filters to attempt to resolve any issues.

The "Limit allowed HTML tags and correct faulty HTML" filter is intentionally disabled by default because this module duplicates the same functionality use its own: Render Strategy.