tanuck/cakephp-markdown

Cakephp Markdown plugin for CakePHP 3.

CakePHP Markdown

, _(*1)

CakePHP 3 plugin to parse markdown syntax in your view templates., _(*2)

Installation

Include the following in your composer.json file:, _(*3)

    "require": {
        "tanuck/cakephp-markdown": "dev-master"
    }

and then run:, _(*4)

composer update, _(*5)

Configuration & Usage

To your config/bootstrap.php file add Plugin::load('Tanuck/Markdown');, _(*6)

Then, load the helper where needed. For example, in your controller:, _(*7)

    class FooController extends AppController
    {
        public $helpers = ['Tanuck/Markdown.Markdown'];
    }

then in your templates, you can output markdown syntax like so:, _(*8)

    echo $this->Markdown->transform($myMarkdownSyntax);

Advanced Configuration

Markdown is rendered using the cebe/markdown library which offers 3 different markdown parser classes., _(*9)

• Markdown - using the original syntax definition: http://daringfireball.net/projects/markdown/syntax
• GithubMarkdown - GitHubs own markdown flavour: https://help.github.com/articles/github-flavored-markdown/
• MarkdownExtra - an extension of the original by michelf: http://michelf.ca/projects/php-markdown/extra/

By default, the plugin will use Markdown, the first of the 3 above. However you can specify which of the 3 you use wish to use when loading the helper. Like so:, _(*10)

    class FooController extends AppController
    {
        public $helpers = [
            'Tanuck/Markdown.Markdown' => [
                'parser' => 'GithubMarkdown'
            ]
        ];
    }

License

cakephp-markdown is offered under an MIT license., _(*11)