Smartdown for Craft
Smartdown for Craft is a Twig Filter which brings the unbridled joy of Markdown Extra and SmartyPants to Craft.
Craft already supports standard Markdown, but sadly standard Markdown doesn't support lots of useful things such as footnotes, fenced code blocks, and tables. It also does nothing to spruce up your typography, leaving your site with an embarrassment of straight quotes, and faux ellipses.
Smartdown plugs both of these gaps, turning your website into a typographic dreamboat.
Requirements
Each release of Smartdown is automatically tested against PHP 7.1 and above. It's also manually tested on the most recent version of Craft.
PHP 7.0 support
In theory, Smartdown should be compatible with PHP 7.0. In practise, it's impossible to test this, because the Codeception dependency tree includes components which only work with PHP 7.1+.
Unfortunately there's nothing we can do about that.
Installation
To install Smartdown, either search for "Smartdown" in the Craft Plugin Store, or add it as a Composer dependency.
Here's how to install Smartdown using Composer.
-
Open your terminal, and navigate to your Craft project:
cd /path/to/project -
Add Smartdown as a project dependency:
composer require experience/smartdown -
In the Control Panel, go to "Settings → Plugins", and click the "Install" button for Smartdown
Basic usage
Use the Smartdown filter in exactly the same way as any other Twig filter.
{{ myVariable|smartdown }}
This will parse your content with both Markdown Extra, and SmartyPants, turning this:
"Outside of a dog, a book is a man's best friend. Inside a dog it's too dark to read..."
Into this:
"Outside of a dog, a book is a man's best friend. Inside a dog it's too dark to read..."
Filter parameters
markup
The markup filter parameter controls whether the text will be parsed using Markdown Extra. The default value is true.
Example usage:
{{ content|smartdown(markup=false) }}
typography
The typography filter parameter controls whether the text will be parsed using SmartyPants. The default value is true.
Example usage:
{{ content|smartdown(typography=false) }}