Fix {@ escaping in markdown to preserve PHPDoc annotations like {@inheritDoc}

src/Console/BuildCommand.php

@@ -42,7 +42,7 @@ protected function fire()
         if ($this->input->getOption('watch')) {
             return $this->watch();
         }
-        
+
         return $this->build();
     }
 
@@ -124,14 +124,14 @@ private function watch()
                 $affectedFiles = 0;
 
                 foreach ($currentTimestamps as $file => $mtime) {
-                    if (!isset($fileTimestamps[$file]) || $fileTimestamps[$file] !== $mtime) {
+                    if (! isset($fileTimestamps[$file]) || $fileTimestamps[$file] !== $mtime) {
                         $affectedFiles++;
                         $this->consoleOutput->writeln('<info>File changed: ' . $file . '</info>');
                     }
                 }
 
                 foreach ($fileTimestamps as $file => $mtime) {
-                    if (!isset($currentTimestamps[$file])) {
+                    if (! isset($currentTimestamps[$file])) {
                         $affectedFiles++;
                         $this->consoleOutput->writeln('<info>File deleted: ' . $file . '</info>');
                     }
@@ -221,7 +221,7 @@ private function confirmDestination()
         if ($this->input->getOption('quiet') || $this->input->getOption('watch')) {
             return true;
         }
-        
+
         $customPath = Arr::get($this->app->config, 'build.destination');
 
         if ($customPath && strpos($customPath, 'build_') !== 0 && file_exists($customPath)) {

src/Handlers/MarkdownHandler.php

@@ -155,6 +155,7 @@ private function getEscapedMarkdownContent($file)
         if (in_array($file->getFullExtension(), ['markdown', 'md', 'mdown'])) {
             $replacements = array_merge([
                 '@' => "{{'@'}}",
+                '{@' => '{@',  // Preserve {@ to avoid {{{'@'}} which is invalid Blade (e.g. {@inheritDoc})
                 '{{' => '@{{',
                 '{!!' => '@{!!',
             ], $replacements);

tests/AtSymbolInMarkdownTest.php

@@ -96,6 +96,24 @@ public function double_at_symbol_in_inline_code_block_is_parsed_to_single_at_sym
         );
     }
 
+    #[Test]
+    public function inheritdoc_annotation_in_code_block_is_preserved_in_markdown()
+    {
+        $files = $this->setupSource([
+            '_layouts' => [
+                'master.blade.php' => "<div>@yield('content')</div>",
+            ],
+            'test.md' => $this->getYamlHeader() .
+                "```php\n{@inheritDoc}\n```",
+        ]);
+        $this->buildSite($files);
+
+        $this->assertEquals(
+            '<div><pre><code class="language-php">{@inheritDoc}</code></pre></div>',
+            $this->clean($files->getChild('build/test.html')->getContent()),
+        );
+    }
+
     public function getYamlHeader()
     {
         return implode("\n", ['---', 'extends: _layouts.master', 'section: content', '---', '']);