1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
---
layout: default
title: Extensions
description: Creating custom extensions to add new syntax and other custom functionality
---
# Extensions
Extensions provide a way to group related parsers, renderers, etc. together with pre-defined priorities, configuration settings, etc. They are perfect for distributing your customizations as reusable, open-source packages that others can plug into their own projects!
To create an extension, simply create a new class implementing `ExtensionInterface`. This has a single method where you're given a `EnvironmentBuilderInterface` to register whatever things you need to. For example:
```php
use League\CommonMark\Extension\ExtensionInterface;
use League\CommonMark\Environment\EnvironmentBuilderInterface;
final class EmojiExtension implements ExtensionInterface
{
public function register(EnvironmentBuilderInterface $environment): void
{
$environment
// TODO: Create the EmojiParser, Emoji, and EmojiRenderer classes
->addInlineParser(new EmojiParser(), 20)
->addInlineRenderer(Emoji::class, new EmojiRenderer(), 0)
;
}
}
```
To hook up your new extension to the `Environment`, simply do this:
```php
use League\CommonMark\Environment\Environment;
use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
use League\CommonMark\MarkdownConverter;
$environment = new Environment();
$environment->addExtension(new CommonMarkCoreExtension());
$environment->addExtension(new EmojiExtension());
$converter = new MarkdownConverter($environment);
echo $converter->convert('Hello! :wave:');
```
|
