[5.x] Added the option to add renderers to markdown parsers

src/Markdown/Parser.php

@@ -15,6 +15,7 @@ class Parser
 
     protected $converter;
     protected $extensions = [];
+    protected $renderers = [];
     protected $config = [];
 
     public function __construct(array $config = [])
@@ -41,6 +42,10 @@ public function converter(): CommonMarkConverter
             $env->addExtension($ext);
         }
 
+        foreach ($this->renderers() as $ren) {
+            $env->addRenderer(...$ren);
+        }
+
         return $this->converter = $converter;
     }
 
@@ -58,6 +63,15 @@ public function addExtension(Closure $closure): self
         return $this;
     }
 
+    public function addRenderers(Closure $closure): self
+    {
+        $this->converter = null;
+
+        $this->renderers[] = $closure;
+
+        return $this;
+    }
+
     public function addExtensions(Closure $closure): self
     {
         return $this->addExtension($closure);
@@ -76,6 +90,19 @@ public function extensions(): array
         return $exts;
     }
 
+    public function renderers(): array
+    {
+        $renderers = [];
+
+        foreach ($this->renderers as $closure) {
+            foreach ($closure() as $renderer) {
+                $renderers[] = $renderer;
+            }
+        }
+
+        return $renderers;
+    }
+
     public function withStatamicDefaults()
     {
         return $this->newInstance()->addExtensions(function () {
@@ -151,6 +178,10 @@ public function newInstance(array $config = [])
             $parser->addExtensions($ext);
         }
 
+        foreach ($this->renderers as $ren) {
+            $parser->addRenderers($ren);
+        }
+
         return $parser;
     }
 }

tests/Markdown/Fixtures/HeadingRenderer.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Tests\Markdown\Fixtures;
+
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\ChildNodeRendererInterface;
+use League\CommonMark\Renderer\NodeRendererInterface;
+
+class HeadingRenderer implements NodeRendererInterface
+{
+    public function render(Node $node, ChildNodeRendererInterface $childRenderer)
+    {
+        if (! ($node instanceof Heading)) {
+            throw new \InvalidArgumentException('Incompatible node type: '.get_class($node));
+        }
+
+        return "<h1 data-custom-renderer>{$childRenderer->renderNodes($node->children())}</h1>";
+    }
+}

tests/Markdown/Fixtures/LinkRenderer.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Tests\Markdown\Fixtures;
+
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link as InlineLink;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\ChildNodeRendererInterface;
+use League\CommonMark\Renderer\NodeRendererInterface;
+
+class LinkRenderer implements NodeRendererInterface
+{
+    public function render(Node $node, ChildNodeRendererInterface $childRenderer)
+    {
+        if (! ($node instanceof InlineLink)) {
+            throw new \InvalidArgumentException('Incompatible node type: '.get_class($node));
+        }
+
+        return "<a data-custom-renderer href=\"{$node->getUrl()}\" title=\"{$node->getTitle()}\">{$childRenderer->renderNodes($node->children())}</a>";
+    }
+}

tests/Markdown/ParserTest.php

@@ -2,6 +2,8 @@
 
 namespace Tests\Markdown;
 
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Markdown;
 use Tests\TestCase;
@@ -54,6 +56,12 @@ public function it_creates_a_new_instance_based_on_the_current_instance()
             return new Fixtures\SmileyExtension;
         });
 
+        $this->parser->addRenderers(function () {
+            return [
+                [Link::class, new Fixtures\LinkRenderer],
+            ];
+        });
+
         $this->assertEquals("\n", $this->parser->config('renderer/block_separator'));
         $this->assertEquals("\n", $this->parser->config('renderer/inner_separator'));
         $this->assertEquals('allow', $this->parser->config('html_input'));
@@ -71,11 +79,33 @@ public function it_creates_a_new_instance_based_on_the_current_instance()
             return new Fixtures\FrownyExtension;
         });
 
+        $newParser->addRenderers(function () {
+            return [
+                [Heading::class, new Fixtures\HeadingRenderer],
+            ];
+        });
+
         $this->assertNotSame($this->parser, $newParser);
         $this->assertEquals("\n", $newParser->config('renderer/block_separator'));
         $this->assertEquals('foo', $newParser->config('renderer/inner_separator'));
         $this->assertEquals('strip', $newParser->config('html_input'));
         $this->assertCount(2, $newParser->extensions());
         $this->assertCount(1, $this->parser->extensions());
+        $this->assertCount(2, $newParser->renderers());
+        $this->assertCount(1, $this->parser->renderers());
+    }
+
+    #[Test]
+    public function it_uses_custom_renderers()
+    {
+        $this->assertEquals("<p><a href=\"http://example.com\">test</a></p>\n", $this->parser->parse('[test](http://example.com)'));
+
+        $this->parser->addRenderers(function () {
+            return [
+                [Link::class, new Fixtures\LinkRenderer],
+            ];
+        });
+
+        $this->assertEquals("<p><a data-custom-renderer href=\"http://example.com\" title=\"\">test</a></p>\n", $this->parser->parse('[test](http://example.com)'));
     }
 }