README

CakePHP 4 plugin to parse markdown syntax in your view templates.

Installation

composer require kitzberger/cakephp-markdown:dev-main

Configuration & Usage

To your config/bootstrap.php file add \App\Application::addPlugin('Tanuck/Markdown');

Then, load the helper where needed. For example, in your controller:

class FooController extends AppController
{
    public function initialize(): void
    {
        parent::initialize();
        $this->viewBuilder()->setHelpers(['Tanuck/Markdown.Markdown']);
    }
}

then in your templates, you can output markdown syntax like so:

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

Advanced Configuration

Markdown is rendered using the cebe/markdown library which offers 3 different markdown parser classes.

• 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:

class FooController extends AppController
{
    public function initialize(): void
    {
        parent::initialize();
        $this->viewBuilder()->setHelpers([
			'Tanuck/Markdown.Markdown' => [
				'parser' => 'GithubMarkdown',
			]
		]);
    }
}

License

cakephp-markdown is offered under an MIT license.