This module allows you to use Markdown, a simple plain-text formatting syntax, within Drupal. It converts your Markdown text into standard HTML, making it easy to write content while still having it display correctly on your website. You can configure which Markdown parser to use and even allow both Markdown and HTML in your content.
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
- 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
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:
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:
-
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
Markdownfilter to it where you can choose to inherit the site-wide settings or override the settings for that particular text format:/admin/config/content/formatsNote: 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.
Documentation
Extensive documentation for this module can be found at:
https://www.drupal.org/docs/contributed-modules/markdown
Editor.md
If you are interested in a Markdown editor please check out the
Editor.md module for Drupal.