用途：把 Markdown 文档（含 YAML frontmatter）转换为符合 RFC 5322 的 .eml 邮件文件，便于在 Outlook、Thunderbird 等邮件客户端中发送格式化内容，适用于新闻通讯、治理沟通、利益相关者更新和邮件模板制作。
主要能力：frontmatter 映射为邮件头（to、from、subject、cc、reply-to）；生成内联 CSS 的邮件安全 HTML（基于表格布局，无 style 块）；本地图片以 base64 CID 附件内嵌；支持标题、粗斜体、链接、代码块、行内代码、表格、引用、列表、Emoji、分隔线等格式；Mermaid 图因邮件客户端无法执行 JS，转为 ASCII 表格回退。
使用方式：需 Node.js 18+ 与 pandoc。基本命令：node .github/muscles/md-to-eml.cjs newsletter.md；测试预览：node .github/muscles/md-to-eml.cjs newsletter.md --test --test-to me@example.com；内嵌图片：node .github/muscles/md-to-eml.cjs update.md --inline-images；调试：node .github/muscles/md-to-eml.cjs update.md --debug。frontmatter 中 to、from、subject 为必填，cc、reply-to 可选。
限制：邮件客户端不执行 JavaScript，Mermaid 仅表格回退；复杂 CSS 在不同客户端渲染有差异；内嵌图片增大邮件体积；部分客户端会剥离 CSS；建议主题不超过 60 字符，.eml 超过 5MB 时改用链接图片。依赖共享模块 markdown-preprocessor.cjs、mermaid-pipeline.cjs。