Ability to blacklist or whitelist certain parsers.

[doZennn]

Description

This would be useful if you want a more control over how content is rendered in your site.

Example use cases: Disabling embedded images and thematic breaks in comments, or only allowing bold, italics, and underlines.

[GrahamCampbell]

This is already supported. :)

[doZennn]

Is it anywhere in the docs? I can't seem to find it.

[colinodell]

The general gist is that you create your own custom extension which only registers the parsers, renderers, etc. for the features you want to support.

Here's the CommonMarkCoreExtension which includes almost everything: https://github.com/thephpleague/commonmark/blob/master/src/Extension/CommonMarkCoreExtension.php

Here's the InlinesOnly extension which only includes things you'd typically find in one-line comments: https://github.com/thephpleague/commonmark/blob/master/src/Extension/InlinesOnly/InlinesOnlyExtension.php

You can use one of those as-is or create your own version to fit your own needs.

I definitely agree that the documentation could be better - PRs would be welcome! 😉

[colinodell]

Oh, one important note - extensions can only add features, not remove them, so don't use CommonMarkConverter or Environment::createCommonMarkEnvironment() as your starting point because that would include everything by default. Instead, do this:

 use League\CommonMark\CommonMarkConverter;
 use League\CommonMark\Environment;
 
 
-$environment = Environment::createCommonMarkEnvironment();
+$environment = new Environment();
+$environment->addExtension(new MyAwesomeCustomExtension());

 $converter = new CommonMarkConverter([], $environment);
 echo $converter->convertToHtml('Hello world!');

[doZennn]

Thank you, managed to get it working!