Decode HTML entities in Blade guideline output

src/Concerns/RendersBladeGuidelines.php

@@ -34,6 +34,8 @@ protected function renderContent(string $content, string $path, array $data = []
             ...$data,
         ]);
 
+        $rendered = html_entity_decode($rendered, ENT_QUOTES | ENT_HTML5);
+
         return str_replace(array_values($placeholders), array_keys($placeholders), $rendered);
     }
 

tests/Unit/Concerns/RendersBladeGuidelinesTest.php

@@ -134,6 +134,30 @@ public function getStoredSnippets(): array
         ->toContain('@endvolt');
 });
 
+test('html entities from blade expressions are decoded back to plain text for markdown output', function (): void {
+    $this->mock(GuidelineAssist::class);
+
+    $content = 'Run {{ "tinker --execute \"your code here\"" }}';
+
+    $result = $this->renderer->render($content, '/path/to/guide.blade.php');
+
+    expect($result)->toContain('tinker --execute "your code here"')
+        ->not->toContain('"');
+});
+
+test('all common html entities are decoded', function (): void {
+    $this->mock(GuidelineAssist::class);
+
+    $content = 'Use {{ "a < b & c > d" }}';
+
+    $result = $this->renderer->render($content, '/path/to/guide.blade.php');
+
+    expect($result)->toContain('a < b & c > d')
+        ->not->toContain('&lt;')
+        ->not->toContain('&amp;')
+        ->not->toContain('&gt;');
+});
+
 test('renderBladeFile returns empty string for non-existent file', function (): void {
     $result = $this->renderer->renderFile('/non/existent/guideline.blade.php');