@markdown 指令需手动注册，否则报错；converttohtml() 返回 document 对象，必须链式调用 getcontent() 才得 html 字符串；注册须在 appserviceprovider::boot() 中，且 converter 应为单例。
直接用 @markdown 指令是最干净的写法，但默认 Laravel 不提供这个指令——得自己注册，否则模板里一写就报错 Class 'markdown' not found 或直接忽略语法。
为什么 @markdown($content) 会报 “Object of class … could not be converted to string”
常见错误是没调 getContent()。CommonMark 的 convertToHtml() 返回的是一个 Document 对象，不是字符串。
-
$converter->convertToHtml($content)→ 返回League\CommonMark\Node\Block\Document - 必须链式调用
->getContent()才能得到 HTML 字符串 - 漏掉这步，Blade 就会尝试把对象转成字符串，触发 PHP 致命错误
在 AppServiceProvider::boot() 里注册指令的最小可行写法
别抄网上带一堆扩展配置的版本，先跑通再加功能。以下代码能直接用，兼容 Laravel 9+（league/commonmark v2+）：
use League\CommonMark\Environment\Environment;
use League\CommonMark\Extension\CommonMark\CommonMarkExtension;
use League\CommonMark\MarkdownConverter;
use Illuminate\Support\Facades\Blade;
<p>// boot() 方法内
$environment = new Environment();
$environment->addExtension(new CommonMarkExtension());
$converter = new MarkdownConverter($environment);</p><p>Blade::directive('markdown', function ($expression) use ($converter) {
return "<?php echo \$converter->convertToHtml($expression)->getContent(); ?>";
});</p>
-
$expression是传进来的变量名（如$post->body），不是值本身，所以要加$符号拼接 - 不要用
eval()或htmlspecialchars()包裹结果——那是你手动渲染时才考虑的事 - 指令注册后，Blade 中写
@markdown($post->body)就生效，不用清缓存
想支持多行 Markdown 块语法（@markdown ... @endmarkdown）怎么办
原生 Blade::directive() 只处理单行形式。要支持块语法，得改用 BladeCompiler::directive() + 自定义编译逻辑，但代价高、易出错。
- 更实际的做法：用
@markdown配合三元或空值合并，比如@markdown($post->body ?? '# 暂无内容') - 真需要块语法，推荐换用
laravel-markdown包（andreasindal/laravel-markdown），它原生支持@markdown ... @endmarkdown和@md别名 - 注意：该包默认启用
HtmlSanitizer，若你允许有限 HTML（如<details></details>），得手动配置白名单，否则标签被删
最常被跳过的细节是：指令注册必须在 boot() 阶段，且 $converter 必须是单例——如果每次调指令都 new 一个 MarkdownConverter，性能会随请求量线性恶化。别图省事把它塞进闭包里反复创建。
