唯一可靠方式是改用 Markdown 模板；MailMessage::action() 按钮颜色由 vendor 模板硬编码为 #3d4852，不支持运行时参数修改，即使传入 color 等参数也无效。
直接改用 Markdown 模板是唯一能真正控制按钮颜色、布局结构和响应式表现的方式；MailMessage::action() 的黑底按钮无法通过参数修改，这是底层模板硬编码决定的，不是你配错了。
为什么不能用 MailMessage 直接改按钮颜色
MailMessage::action() 生成的 HTML 实际来自 resources/views/vendor/notifications/email.blade.php，这个文件里按钮的 background-color 是写死的 #3d4852（深灰），不接受任何运行时传参。哪怕你试过 ->action('Click', $url, ['color' => 'blue'])，也完全无效——Laravel 根本没定义这个参数签名。
常见错误现象：
- 调用
->action()后按钮仍是黑色，检查了 config/services.php 和 mail.php 也没用 - 试图在
toMail()里 return 一个带 style 的<a>标签，但邮件客户端（尤其是 Outlook）会过滤或重置内联样式 - 用
view()手动指定 Blade 模板，却忘了通知类默认不走 Markdown 渲染流程，导致 CSS 不加载、组件不识别
生成并注册 Markdown 邮件通知类
必须用 make:notification 命令带 --markdown 参数，否则不会生成对应视图目录和自动启用 Markdown 渲染器：
php artisan make:notification PasswordResetRequested --markdown=mail.password.reset
这条命令会做三件事：
- 创建
app/Notifications/PasswordResetRequested.php，其中toMail()返回new MailMessage的逻辑会被忽略，实际走的是 Markdown 模板 - 生成视图文件
resources/views/mail/password/reset.blade.php - 自动在通知类中添加
use Illuminate\Bus\Queueable;和use Illuminate\Notifications\Messages\MailMessage;（但注意：这里MailMessage只用于兼容旧写法，真正渲染靠的是 Blade）
别手动复制 email.blade.php 或改 vendor 文件——升级 Laravel 时会被覆盖，且违反约定。
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
在 Markdown 模板里正确使用 mail::button
Markdown 模板不是纯 Markdown，而是 Laravel 提供的扩展语法，mail::button 是一个 Blade 组件，支持 color 属性（仅限预设值）或 style（推荐）：
@component('mail::message')
## 密码重置请求
<p>您正在尝试重置账户密码。</p><p>@component('mail::button', ['url' => $url, 'color' => 'success'])
重置密码
@endcomponent</p><p>@component('mail::button', ['url' => $url, 'style' => 'background-color:#2563eb;color:#fff;border-radius:6px;'])
蓝色按钮（自定义）
@endcomponent</p><p>谢谢使用！<br />
{{ config('app.name') }}
@endcomponent关键点：
-
color只接受primary、success、error三种，对应固定色值，不可扩展 -
style是更可靠的选择，但注意：Gmail 会 strip 掉部分 CSS，所以background-color、color、border-radius是安全的，box-shadow或transition则无效 - 所有变量（如
$url）必须在通知类的toMail()方法中通过->with()显式传递：return (new MailMessage)->with(['url' => $resetUrl]);
调试与预览 Markdown 邮件的实际效果
别依赖本地 php artisan serve 直接打开 Blade 文件——它缺少 Laravel 邮件组件的上下文，mail::button 会报错或渲染为空白。
正确做法是用 Laravel 内置的预览功能：
- 运行
php artisan mail:preview PasswordResetRequested（需 Laravel 9+），它会启动一个临时 HTTP 服务，返回可点击的 HTML 预览页 - 若提示找不到命令，说明未启用邮件预览功能：确认
config/mail.php中'pretend' => true已关闭，且APP_ENV=local - 真实测试前，务必用 MailHog 或 Ethereal（
https://ethereal.email）捕获原始邮件源码，检查是否含Content-Type: multipart/alternative和正确的text/htmlbody —— Markdown 模板最终会被编译成标准 HTML 邮件
最容易被忽略的一点：Markdown 模板里的 @component('mail::message') 必须作为最外层包裹，且不能嵌套其他 @component，否则渲染器会静默失败，只显示空白邮件。
